CLI Command Reference

Complete reference for reedle-cli v0.3.0. All commands support --json and --no-color global flags.

Auth

Command	Description
`auth token <rdk_xxx>`	Set your Personal Access Token (get from Settings → Integrations)
`auth whoami`	Show currently authenticated user
`auth logout`	Remove stored credentials

Save content to library

Command	Flags	Description
`save <url>`	`-t <tag>` (repeatable)	Save a web article. Processing is async — article appears in inbox within seconds.
`save-youtube <url>`	`--lang <code>`, `-l <list_id>`	Save a YouTube video with its transcript. Pass URL or video ID.
`save-bilibili <url>`	`--cookie <str>` (required), `--page <n>`, `-l <list_id>`	Save a Bilibili video transcript. Cookie required — get from browser devtools.

Read without saving

Command	Flags	Description
`read <url>`	`--youtube`, `--bilibili`, `--llm`, `--save`, `--lang`, `--cookie`	Extract content from a URL without saving to library. Costs credits. Output goes to stdout for piping.

Examples

reedle read https://arxiv.org/abs/2310.06825 | glow
reedle read https://youtu.be/dQw4w9WgXcQ --youtube | less

Library navigation

Command	Flags	Description
`list`	`-t <tag>`, `-l <list_id>`, `-s <status>`, `--starred`, `-n <limit>`, `--offset <n>`	List articles in your library
`show <id>`		Show article metadata: title, URL, site, status, tags, highlights count
`cat <id>`		Output full article content to stdout. Pipe-friendly: `reedle cat <id> \| glow`
`open <id>`		Open article in browser (web app)
`search <query>`	`--semantic`, `-n <limit>`	Search by keyword or AI semantic search
`tags`		List all tags with counts
`lists`		List all reading lists

Actions

Command	Description
`star <id>`	Star an article
`unstar <id>`	Unstar an article
`archive <id>`	Archive an article (per-user, doesn't affect others)
`unarchive <id>`	Unarchive an article
`delete <id> --force`	Soft-delete an article. `--force` required to prevent accidents.
`tag <id> <tag>`	Add a tag to an article
`untag <id> <tag>`	Remove a tag from an article

Interactive TUI

Command	Flags	Description
`browse`	`-t <tag>`, `--starred`, `-l <list_id>`	Open 3-pane TUI: sidebar / article list / preview. No external tools required. See Browse TUI →

TUI keyboard shortcuts

Quick reference for reedle browse key bindings.

Key	Context	Action
`j / k`	Any pane	Navigate up / down
`Tab`	3-pane view	Cycle focus: sidebar → list → preview
`1 / 2 / 3`	3-pane view	Jump to sidebar / list / preview
`Enter`	List or preview	Open fullscreen reader
`/`	3-pane view	Live search (title, site, tags)
`s`	List pane	Toggle star
`a`	List pane	Toggle archive
`d` `d`	List pane	Delete (press twice to confirm)
`t`	List pane	Add tag (opens prompt)
`o`	List / reader	Open in browser
`r`	3-pane view	Refresh from API
`b` / `Esc`	Reader	Back to 3-pane view
`q`	Reader	Exit reader (back to list)
`q`	3-pane view	Quit TUI

Scripting examples

Scripting

# Get all starred articles as JSON, extract titles
reedle list --starred --json | jq '.[].title'

# Save all URLs from a file
cat urls.txt | xargs -I{} reedle save {}

# Extract and render article in terminal
reedle cat $(reedle list --json | jq -r '.[0].id') | glow

# Search and get first result ID
reedle search "LLM reasoning" --json | jq -r '.[0].id'

# Archive all failed articles
reedle list --status failed --json | jq -r '.[].id' | xargs -I{} reedle archive {}