How to use the Readwise CLI — access highlights, documents, and your entire reading library from the command line

Readwise CLI Use the readwise command to access the user's Readwise highlights and Reader documents. Readwise has two products: Readwise — highlights from books, articles, podcasts, and more. Includes daily review and spaced repetition. Reader — a read later app for saving and reading articles, PDFs, EPUBs, RSS feeds, emails, tweets, and videos. Setup If readwise is not installed: If not authenticated, ask the user for their Readwise access token (they can get one at https://readwise.io/access token), then run: Discovering Commands Every command supports help for full option details: Add json to any command for machine readable output. Use refresh to force refresh cached data. Reader Commands Searching documents Browsing documents Locations: new (inbox), later , shortlist , archive , feed . When the user says "inbox", use new . Reading and highlighting Saving documents Organizing Exporting Readwise Commands Searching highlights Full text query fields: document author , document title , highlight note , highlight plaintext , highlight tags . Browsing highlights Creating and editing highlights Colors: yellow , blue , pink , orange , green , purple . Daily review Returns highlights selected by the spaced repetition algorithm plus a URL for interactive review. Example Workflows Triage the inbox: List recent saves, read each one, decide what's worth the user's time. Search across everything: Find all content on a topic across both highlights and documents. Quiz on a recent read: Find a finished document, get its content and highlights, quiz the user. Catch up on RSS: Browse feed items, surface the best ones, mark the rest as seen. Save and annotate: Save a URL, highlight key passages, tag and organize. Build a reading recap: See what you've finished and highlighted recently.

readwise-cli