Readwise Reader CLI


A command-line interface for the Readwise Reader API.

Based on the official Readwise Reader API.

Installation

``bash
npm install -g readwise-reader-cli
`

Or run directly with npx:

`bash
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:

`bash
export READWISE_TOKEN=your_token_here
`

Or create a .env file in your project:

`
READWISE_TOKEN=your_token_here
`

Usage

$3

`bash


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
`

$3

`bash


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
`

$3

`bash


Update title

reader update --title "New Title"

Update multiple fields

reader update \
--title "New Title" \
--author "Jane Doe" \
--location archive

Update tags

reader update --tags "new,tags"
`

$3

`bash
reader delete
`

$3

`bash
reader tags
reader tags --json
`

$3

`bash
reader auth
`

Options

$3

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

$3

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

$3

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

Development

`bash


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