# Readwise CLI Command-line interface for [[Readwise]] and Reader. Lets AI agents (like [[Claude Code]], Codex, OpenClaw) and humans interact with their Readwise library directly from the terminal. ## Installation ```bash # Install and login (opens browser for OAuth) npx @readwise/cli login # Or with bun bunx @readwise/cli login # Token-based login (for CI/headless) bunx @readwise/cli login-with-token ``` After login, the `readwise` command is available. Discover all capabilities with `readwise --help`. ## Key commands ```bash # Search Reader library readwise reader-search-documents --query "aggregation theory" # Read a saved document (returns Markdown) readwise reader-get-document-details --document-id <id> # Save a URL to Reader readwise reader-create-document --url "https://example.com/article" # Check inbox readwise reader-list-documents --location new # Move documents (archive, later, shortlist) readwise reader-move-documents --document-ids <id>,<id> --location archive # Search highlights (vector search) readwise readwise-search-highlights --vector-search-term "compounding" # Create a highlight readwise reader-create-highlight --document-id <id> --text "The key insight is..." # Tag documents readwise reader-add-tags-to-document --document-id <id> --tags "ai,research" # Daily review readwise readwise-get-daily-review # Export entire library as Markdown readwise reader-export-documents ``` ## Skills integration Install [[Readwise AI Skills]] for [[Claude Code]]: ```bash npx @readwise/cli skills install claude ``` ## References - https://readwise.io/cli - npm: https://www.npmjs.com/package/@readwise/cli - GitHub (CLI): https://github.com/readwiseio/readwise-cli ## Related - [[Readwise]] - [[Readwise MCP Server]] - [[Readwise AI Skills]] - [[Claude Code]]