api2cliapi2cli
Get Started
← Back to CLIs
Nardjo

readwise-cli

Manage Readwise & Reader via CLI - documents, tags, highlights, books, review. Use when user mentions 'readwise', 'reader', 'read later', 'reading list', 'save article', 'highlights', 'daily review', 'book notes', or wants to interact with the Readwise API.

productivity

Install

$ npx api2cli install Nardjo/readwise-cli

Details

Skill type: Wrapper CLI
Auth type: bearer
Version: 0.1.0
Author: Nardjo
Views: 0
Repo: https://github.com/Nardjo/readwise-cli

README

readwise-cli

Unified CLI for Readwise (highlights, books, daily review) and Readwise Reader (documents, reading queue). Made with api2cli.dev.

Install

npx api2cli install Nardjo/readwise-cli

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Install AgentSkill only

npx skills add Nardjo/readwise-cli

Setup

Get your token from https://readwise.io/access_token

readwise-cli auth set "your-token"
readwise-cli auth test

Resources

Reader API (v3)

ResourceActionsAlias
documentslist, get, save, update, bulk-update, deletedoc
tagslisttag

Readwise API (v2)

ResourceActionsAlias
highlightslist, get, create, update, delete, export, tagshl
bookslist, get, tagsbook
reviewtoday—

Examples

# Save an article to Reader
readwise-cli doc save --url "https://example.com" --location later

# List highlights for a book
readwise-cli hl list --book-id 123 --json

# Export all recent highlights
readwise-cli hl export --updated-after 2024-01-01 --json

# Get today's daily review
readwise-cli review today

# List all books
readwise-cli books list --category articles

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header

Sponsors