Readwise Reader CLI

A command-line interface for the Readwise Reader API.

Based on the official Readwise Reader API.

Installation

npm install -g readwise-reader-cli

Or run directly with npx:

npx readwise-reader-cli list
npx readwise-reader-cli save https://example.com

Setup

1. Get your Readwise access token from readwise.io/access_token

2. Set the token as an environment variable:

export READWISE_TOKEN=your_token_here

Or create a .env file in your project:

READWISE_TOKEN=your_token_here

Usage

List documents

# List all documents
reader list

# Filter by location
reader list --location later

# Filter by category
reader list --category article

# Limit results
reader list --limit 10

# Output as JSON
reader list --json

Save a document

# Save a URL
reader save https://example.com/article

# With metadata
reader save https://example.com/article \
  --title "My Article" \
  --author "John Doe" \
  --tags "tech,programming" \
  --location later

# Output as JSON
reader save https://example.com/article --json

Update a document

# Update title
reader update <document-id> --title "New Title"

# Update multiple fields
reader update <document-id> \
  --title "New Title" \
  --author "Jane Doe" \
  --location archive

# Update tags
reader update <document-id> --tags "new,tags"

Delete a document

reader delete <document-id>

List tags

reader tags
reader tags --json

Verify authentication

reader auth

Options

Global options

| Option | Description | |--------|-------------| | --json | Output results as JSON | | --help | Show help | | --version | Show version |

Location values

• new - Inbox
• later - Read Later
• archive - Archive
• feed - Feed

Category values

• article
• email
• rss
• highlight
• note
• pdf
• epub
• tweet
• video

Development

# Clone the repository
git clone https://github.com/lis186/readwise-reader-cli.git
cd readwise-reader-cli

# Install dependencies
npm install

# Run in development mode
npm run dev -- list

# Run tests
npm test

# Build
npm run build

License

MIT