readerctl

CLI for Readwise Reader. Add URLs to your reading list.

Extra: uv tool install buvis-gems[readerctl]

Configuration

Setting	Default	Description
token_file	~/.config/scripts/readwise-token	Path to API token file

Commands

readerctl login

Authenticate with Readwise. Prompts for token and stores it.

readerctl login

readerctl add

Add URL(s) to Reader. Requires prior login.

readerctl add -u https://example.com/article
readerctl add -f ~/urls.txt     # one URL per line

Options:

• -u, --url TEXT — single URL to add

• -f, --file TEXT — file with URLs (one per line)