Reedle CLI
A terminal-native interface to your Reedle library. Save articles, search your reading history, extract content for pipelines, and browse interactively — all from the command line.
Three use cases
| Use case | Example |
|---|---|
| Automation | Pipe URLs into reedle save, extract content with reedle cat, feed into grep, jq, LLM prompts |
| Power-user manual | Quickly save or read an article without opening the browser |
| Interactive browse | reedle browse — fuzzy-search your library with live preview (requires fzf) |
Install
Terminal
npm install -g reedle-cli
# or
pnpm add -g reedle-cli
# or
npx reedle-cli --helpRequires Node.js 18+.
Authenticate
Terminal
# 1. Get your token: Reedle → Settings → Integrations → CLI Token
reedle auth token rdk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Verify
reedle auth whoamiToken stored at ~/.config/reedle/credentials.json (macOS: ~/Library/Application Support/reedle/). Override with REEDLE_TOKEN=rdk_xxx env var.
Quick examples
Terminal
# Save an article
reedle save https://arxiv.org/abs/2310.06825
# Output content to stdout (pipe-friendly)
reedle cat <id> | glow
# Search semantically
reedle search "transformer attention" --semantic
# Browse interactively
reedle browse --starredAuthentication model
The CLI uses a Personal Access Token (PAT) with the rdk_ prefix — the same token type used by the MCP server. It authenticates against the same reedle-mcp/v1 REST API that backs the MCP tools. Generate separate tokens for CLI and MCP in Settings → Integrations.
Global flags
--json | Output as JSON — pipe to jq for scripting |
--no-color | Disable ANSI color output |
-V, --version | Show installed version |