reedle

name	reedle
description	reedle - The Reedle CLI for managing your intelligent reading library and extracting content
allowed-tools	Bash(reedle *), mcp__reedle__reedle_list_articles, mcp__reedle__reedle_get_article, mcp__reedle__reedle_get_article_content, mcp__reedle__reedle_create_article, mcp__reedle__reedle_update_article, mcp__reedle__reedle_delete_article, mcp__reedle__reedle_search_articles, mcp__reedle__reedle_search_semantic, mcp__reedle__reedle_find_similar_articles, mcp__reedle__reedle_list_tags, mcp__reedle__reedle_tag_article, mcp__reedle__reedle_list_lists, mcp__reedle__reedle_get_list, mcp__reedle__reedle_list_highlights, mcp__reedle__reedle_get_highlight, mcp__reedle__reedle_list_comments, mcp__reedle__reedle_save, mcp__reedle__reedle_save_youtube, mcp__reedle__reedle_save_bilibili, mcp__reedle__reedle_read, mcp__reedle__reedle_read_youtube, mcp__reedle__reedle_read_bilibili, mcp__reedle__reedle_get_processing_status, mcp__reedle__reedle_get_credit_balance, mcp__reedle__reedle_list_decks, mcp__reedle__reedle_list_cards_due, mcp__reedle__reedle_get_study_stats
user-invocable	true
argument-hint	<command> [options]
updated	2026-03-24-v0.3.0

reedle — Intelligent Reading Companion CLI

Manage your Reedle reading library and extract content from the terminal or as an AI agent.

Tool preference: Use reedle CLI (Bash) for all operations — it's faster, token-efficient, and composable with grep, jq, and pipes. Use mcp__reedle__* MCP tools as fallback when the CLI is not installed or when complex multi-step MCP tool chains are more appropriate.

Install: npm install -g reedle-cli

Auth: Generate a CLI token at app.reedle.iopho.com → Settings → Integrations → CLI Token, then:

reedle auth token rdk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

Global Flags

Flag	Description
--json	Output as JSON (for scripting / jq)
--no-color	Disable color output
-V, --version	Show version

---

Auth

reedle auth token <rdk_xxx>   # Set PAT (get from web Settings → Integrations → CLI Token)
reedle auth whoami             # Verify token + show status
reedle auth logout             # Remove stored credentials

Token stored in ~/.config/reedle/credentials.json (or ~/Library/Application Support/reedle/ on macOS). Override with env var: REEDLE_TOKEN=rdk_xxx reedle list

---

CRITICAL: Save vs Read Decision Rule

Before using any save/read tool, determine user intent:

User says…	Use
"save", "add", "keep", "bookmark"	reedle save / reedle_save*
"read", "summarize", "check", "fetch", "what does this say"	reedle read / reedle_read*