A CLI for everything you've read.
Search, read, and organize your Readwise and Reader data. Works with Claude Code, Codex, OpenClaw, or any AI agent.
Install
Two commands. That's it. Login opens your browser for OAuth.
npm install -g @readwise/cli
readwise login
# Or, for scripts and headless agents
# get your access token from readwise.io/access_token then:
# readwise login-with-token <your-access-token>
Your agent (Claude Code, Codex, OpenClaw, etc.) can now use the readwise command, and discover everything it can do with readwise --help.
What You Can Do
Every word of every article, book, PDF, podcast, newsletter, and highlight you've ever saved, semantically indexed and searchable. Use these directly, pipe to other tools, or let your AI agent use them for you.
# Search your 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 your inbox
readwise reader-list-documents --location new
# Move documents to archive, later, or shortlist
readwise reader-move-documents --document-ids <id>,<id> --location archive
# Search your Readwise highlights
readwise readwise-search-highlights --vector-search-term "compounding"
# Create a highlight
readwise reader-create-highlight --document-id <id> --text "The key insight is..."
# Tag and organize documents
readwise reader-add-tags-to-document --document-id <id> --tags "ai,research"
# Get today's daily review
readwise readwise-get-daily-review
# Export your entire library as Markdown
readwise reader-export-documentsSkills
Pre-built workflows your AI agent can run. Install them with one command:
npx @readwise/cli skills install claude| Skill | What it does |
|---|---|
| Triage | AI walks you through your inbox one article at a time, telling you what's worth your time and why |
| Feed Catchup | Skim your Reader feed in batches — RSS, newsletters, Twitter digests — pull out the gems, mark the rest as seen |
| Quiz | Test yourself on something you just read — graded like a smart colleague who also read the piece |
| Now Reading | Generate a "What I'm Reading" webpage from your library — host it on your personal site |
Looking for MCP?
Using Claude Desktop, ChatGPT, or another AI app? Connect Readwise via MCP — no terminal needed.