A CLI for Reddit โ browse feeds, read posts, search, and interact via reverse-engineered API ๐.
$ npx -y skills add public-clis/rdt-cli --agent claude-code
A CLI for Reddit โ browse feeds, read posts, search, and interact via reverse-engineered API ๐
English | ไธญๆ
--subs-only)--expand-more loads additional more comments entriesrdt show 3 to read, rdt open 3 to browser-o file.json on any listingsec-ch-ua alignment, Gaussian jitter, exponential backoff--yaml, --json, --output FILE, --compact, --full-textok/schema_version/data/error--compact for token-efficient outputAI Agent Tip: Prefer
--yamlfor structured output unless strict JSON is required. Non-TTY stdout defaults to YAML automatically. Use--compactto reduce token usage.
# Recommended: uv tool (fast, isolated)
uv tool install rdt-cli
# Or: pipx
pipx install rdt-cli
Upgrade to the latest version:
uv tool upgrade rdt-cli
# Or: pipx upgrade rdt-cli
From source:
git clone git@github.com:jackwener/rdt-cli.git
cd rdt-cli
uv sync
# โโโ Auth โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
rdt login # Extract cookies from browser
rdt status # Check login status
rdt status --json # Structured JSON envelope
rdt whoami # Detailed profile (karma, account age)
rdt logout # Clear saved cookies
# โโโ Browse โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
rdt feed # Home feed (requires login)
rdt feed --subs-only # Subscriptions-only feed (no algorithm)
rdt feed --subs-only -n 5 --max-subs 10 # Limit per-sub posts and max subs
rdt popular # Popular posts
rdt popular --full-text # Show full titles
rdt all # /r/all
rdt sub python # Browse subreddit
rdt sub programming -s top -t week # Sort + time filter
rdt sub-info python # Subreddit info (subscribers, etc.)
rdt user spez # User profile
rdt user-posts spez # User's submitted posts
rdt user-comments spez # User's comments
rdt saved # Your saved posts/items
rdt upvoted # Your upvoted posts
# Short index works after list commands (feed/popular/sub/search)
rdt sub python
rdt show 1 # Read post #1 from listing
rdt open 1 # Open post #1 in browser
rdt upvote 1 # Upvote post #1
# โโโ Reading โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
rdt read 1abc123 # Read post by ID
rdt read 1abc123 --expand-more # Expand top-level "more comments"
rdt show 3 # Read result #3 from last listing
rdt show 3 --expand-more # Expand additional comments from cache-backed post
rdt show 1 -s top # Sort comments by top
rdt open 3 # Open in browser
# โโโ Search โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
rdt search "python async" # Global search
rdt search "rust vs go" -r programming # Within subreddit
rdt search "ML" -s top -t year # Sort by top, last year
rdt search "AI" -o results.json # Save to file
rdt search "rust" --compact --json # Compact agent output
# โโโ Export โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
rdt export "python tips" -n 100 -o tips.csv
rdt export "rust" --format json -o results.json
# โโโ Interactions (require login) โโโโโโโโโโโโโโโโโ
rdt upvote 3 # Upvote result #3
rdt upvote 3 --down # Downvote
rdt upvote 3 --undo # Remove vote
rdt save 3 # Save result #3
rdt save 3 --undo # Unsave
rdt subscribe python # Subscribe to r/python
rdt subscribe python --undo # Unsubscribe
rdt comment 3 "Great post!" # Comment on result #3
rdt-cli supports browser cookie extraction to authenticate with Reddit:
~/.config/rdt-cli/credential.jsonrdt login automatically tries all installed browsers and uses the first one with valid cookies.
Saved cookies are valid for 7 days by default. After that, the client automatically attempts to refresh from the browser. If browser extraction fails, the existing cookies are used with a warning.
After any listing command such as feed, popular, all, sub, or search, the CLI stores the latest ordered post list in ~/.config/rdt-cli/index_cache.json.
rdt show <N> reads the Nth post from the latest listingrdt open <N> opens the Nth post in the browserrdt upvote <N>, rdt save <N>, rdt comment <N> reuse the same short index| Variable | Default | Description |
|---|---|---|
OUTPUT | auto | Output format: json, yaml, rich, or auto (โ YAML when non-TTY) |
rdt-cli includes anti-detection measures designed to minimize risk:
sec-ch-ua, sec-ch-ua-platform, sec-ch-ua-mobile are all consistent (Chrome 133)All --json / --yaml output uses the shared envelope from SCHEMA.md:
ok: true
schema_version: "1"
data: { ... }
When stdout is not a TTY (e.g., piped or invoked by an AI agent), output defaults to YAML.
Use OUTPUT=yaml|json|rich|auto to override.
rdt-cli ships with a SKILL.md that teaches AI agents how to use it.
npx skills add jackwener/rdt-cli
| Flag | Description |
|---|---|
-g | Install globally (user-level, shared across projects) |
-a claude-code | Target a specific agent |
-y | Non-interactive mode |
mkdir -p .agents/skills
git clone git@github.com:jackwener/rdt-cli.git .agents/skills/rdt-cli
โ ๏ธ ClawHub ๅฎ่ฃ ๆนๅผๅทฒ่ฟๆถ๏ผไธๅๆฏๆใ่ฏทไฝฟ็จไธๆน็ Skills CLI ๆๆๅจๅฎ่ฃ ใ
rdt_cli/
โโโ __init__.py # Version
โโโ __main__.py # python -m rdt_cli entry point
โโโ cli.py # Click entry point & command registration
โโโ client.py # Reddit API client (rate-limit, retry, anti-detection)
โโโ auth.py # Cookie authentication + TTL refresh
โโโ constants.py # URLs, headers, sort options
โโโ exceptions.py # Error hierarchy (6 exception types)
โโโ index_cache.py # Short-index cache for show/open commands
โโโ commands/
โโโ _common.py # Shared helpers (envelope, output routing, formatters)
โโโ auth.py # login, logout, status, whoami
โโโ browse.py # feed, popular, all, sub, sub-info, user, user-posts, user-comments, saved, upvoted, open
โโโ post.py # read, show
โโโ search.py # search, export
โโโ social.py # upvote, save, subscribe, comment
# Install dependencies
uv sync
# Run tests
uv run pytest tests/ -v
# Unit tests only (no network)
uv run pytest tests/ -v -m "not smoke"
# Smoke tests (need cookies)
uv run pytest tests/ -v -m smoke
# Lint
uv run ruff check .
Q: No Reddit cookies found
rdt login (auto-detects browser)Q: database is locked
Close the browser Cookie database lock โ close browser, then retry rdt login.
Q: Session expired
Your cookies have expired. Run rdt logout && rdt login to refresh.
Q: Rate limited
Wait and retry; the built-in exponential backoff handles this automatically.
Q: Requests are slow
The built-in Gaussian jitter delay (~1s between requests) is intentional to mimic natural browsing and avoid triggering Reddit's rate limiting.
--subs-only๏ผ--expand-more ๅฏๅฑๅผ้ขๅค่ฏ่ฎบrdt show 3 ้
่ฏปใrdt open 3 ๆต่งๅจๆๅผ--yaml / --json๏ผ้ TTY ้ป่ฎค่พๅบ YAML# ๆจ่๏ผuv tool๏ผๅฟซ้ใ้็ฆป็ฏๅข๏ผ
uv tool install rdt-cli
# ๆ่
๏ผpipx
pipx install rdt-cli
ๅ็บงๅฐๆๆฐ็ๆฌ๏ผ
uv tool upgrade rdt-cli
# ๆ๏ผpipx upgrade rdt-cli
ไปๆบ็ ๅฎ่ฃ ๏ผ
git clone git@github.com:jackwener/rdt-cli.git
cd rdt-cli
uv sync
View @jackwenerโs profileConvert any website into a CLI & run Browser Use on your logged-in Chrome. Turn websites and browser sessions into deterministic interfaces for humans and AI agents. Or run Browser Use against any page โ navigate, fill forms, click, extract, automate.
@jackwenerFetch WeChat Official Account articles and convert them to clean Markdown.
@jackwenerA CLI for Bilibili โ browse videos, users, favorites from the terminal ๐บ
@jackwenerrdt-cli is a Claude Code plugin with 1 hand-picked skill, indexed on Flowy in the CLI Tools category. Install it with the command on its page. It includes rdt-cli. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it