Stats
Actions
Tags
From workflows
List, search, save, update, and delete Readwise Reader documents via CLI. Manages document library with filtering, tagging, and bulk operations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/workflows:readwise-docslibrarianThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
CRUD operations on the Reader document library via official CLI (`readwise`) and custom CLI (`readwise-custom`).
CRUD operations on the Reader document library via official CLI (readwise) and custom CLI (readwise-custom).
readwise)readwise reader-list-documents # All documents (limit 10)
readwise reader-list-documents --limit 20 # First 20
readwise reader-list-documents --tag "proxy advisors" # By tag (up to 5 for AND logic)
readwise reader-list-documents --category pdf --location archive # By category + location
readwise reader-list-documents --updated-after 2026-01-01T00:00:00Z
readwise reader-list-documents --seen false # Unseen only
readwise reader-list-documents --response-fields title,author,summary # Reduce token usage
readwise reader-list-documents --id <id> # Specific document
Filter values:
| Flag | Values |
|---|---|
--location | new (inbox), later, shortlist, archive, feed |
--category | article, email, rss, highlight, note, pdf, epub, tweet, video, podcast, audiobook |
--tag | Any tag name (up to 5 tags for AND logic) |
--seen | true (opened), false (unopened) |
readwise reader-search-documents --query "proxy advisors"
readwise reader-search-documents --query "regulation" --author-search "Jackson"
readwise reader-search-documents --query "AI" --category-in article --location-in later,archive
readwise reader-search-documents --query "climate" --published-date-gt 2025-01-01
readwise reader-get-document-details --document-id <id> # Returns markdown content
readwise reader-create-document --url https://example.com/article
readwise reader-create-document --url https://example.com --title "Title" --tags research,ai --notes "Note"
readwise reader-create-document --title "Custom Doc" --markdown "# Content..." --url "https://me.com#doc1"
readwise reader-move-documents --document-ids <id1>,<id2> --location archive # Max 50 per call
readwise reader-move-documents --document-ids <id> --location later
readwise reader-bulk-edit-document-metadata --documents '[{"document_id": "<id>", "seen": true}]'
readwise reader-bulk-edit-document-metadata --documents '[{"document_id": "<id>", "title": "New Title"}]'
readwise reader-list-tags # List all tags
readwise reader-add-tags-to-document --document-id <id> --tag-names important,research
readwise reader-remove-tags-from-document --document-id <id> --tag-names old-tag
readwise reader-get-document-highlights --document-id <id>
readwise reader-create-highlight --document-id <id> --html-content "<p>passage</p>"
readwise reader-create-highlight --document-id <id> --html-content "<p>passage</p>" --note "Note" --tags concept
readwise reader-add-tags-to-highlight --document-id <id> --highlight-document-id <hid> --tag-names concept
readwise reader-set-highlight-notes --document-id <id> --highlight-document-id <hid> --notes "Updated note"
readwise reader-export-documents # Full library as ZIP of markdown
readwise reader-export-documents --since-updated "2026-01-01T00:00:00Z" # Delta export
readwise reader-get-export-documents-status --export-id <id> # Check status
readwise-custom)readwise-custom delete <id>
readwise-custom highlights # All highlights
readwise-custom highlights --search "fiduciary" # Keyword search
readwise-custom highlights --book-id 12345 --json # By source
readwise-custom books # All sources
readwise-custom books --category articles --search "law"
readwise-custom upload <file.pdf>
readwise-custom upload <file.epub>
All commands support --json for machine-readable output:
# Get IDs of all PDFs
readwise reader-list-documents --category pdf --json | jq -r '.results[].id'
# Count highlights per book
readwise-custom books --json | jq '.[] | {title, num_highlights}'
# Export all tags
readwise reader-list-tags --json > tags.json
npx claudepluginhub edwinhu/workflows --plugin workflowsAccesses Readwise highlights, Reader documents, and reading library via MCP tools like reader_search_documents and reader_list_documents. Supports hybrid search, filtering by tags/authors/dates, and pagination across inbox, archive, and feeds.
Searches, retrieves, and manages Readwise highlights, documents, and annotations. Delegates all Readwise operations to a librarian sub-agent.
Creates bite-sized, testable implementation plans from specs or requirements, with file structure and task decomposition. Activates before coding multi-step tasks.