readwise

# Readwise & Reader Skill Access your Readwise highlights and Reader saved articles. ## Setup Get your API token from: https://readwise.io/access_token Set the environment variable: ```bash export READWISE_TOKEN="your_token_here" ``` Or add to ~/.clawdbot/clawdbot.json under "env". ## Readwise (Highlights) ### List books/sources ```bash node {baseDir}/scripts/readwise.mjs books [--limit 20] ``` ### Get highlights from a book ```bash node {baseDir}/scripts/readwise.mjs highlights [--book-id 123] [--limit 20] ``` ### Search highlights ```bash node {baseDir}/scripts/readwise.mjs search "query" ``` ### Export all highlights (paginated) ```bash node {baseDir}/scripts/readwise.mjs export [--updated-after 2024-01-01] ``` ## Reader (Saved Articles) ### List documents ```bash node {baseDir}/scripts/reader.mjs list [--location new|later|archive|feed] [--category article|book|podcast|...] [--limit 20] ``` ### Get document details ```bash node {baseDir}/scripts/reader.mjs get <document_id> ``` ### Save a URL to Reader ```bash node {baseDir}/scripts/reader.mjs save "https://example.com/article" [--location later] ``` ### Search Reader ```bash node {baseDir}/scripts/reader.mjs search "query" ``` ## Notes - Rate limits: 20 requests/minute for Readwise, varies for Reader - All commands output JSON for easy parsing - Use `--help` on any command for options