Ocean
0c4bcdbb86
* feat(reddit): subscribed command + expose id/created_utc/selftext on listing commands Adds `opencli reddit subscribed` to list the user's subscribed subreddits, mirroring `saved.js`'s cookie auth + AuthRequiredError pattern. Auto-paginates via `/subreddits/mine/subscriptions.json` (max 1000 subs, default 100). Also extends the JSON output of `popular` / `search` / `subreddit` with `id`, `created_utc`, `selftext` (and `author` on popular) — the table view stays clean (columns: unchanged), but `--format json` now surfaces fields needed for downstream content-recommendation tooling that filters by post age, dedupes by post id, or uses self-post bodies for embeddings. Tests: 4 new vitest cases for subscribed.js (happy / auth fail / HTTP / --limit truncation). All existing reddit tests still pass. Note on cli-manifest.json diff: the rebuild on fork/main drops 13 entries whose source files import lowercase `selectorError` from `@jackwener/opencli/errors` (the actual export is `SelectorError` — casing bug pre-existing in fork/main). Not introduced by this PR. * fix(reddit): harden subscribed listing contract * fix(reddit): require subreddit identity for subscriptions --------- Co-authored-by: jackwener <jakevingoo@gmail.com>
3.3 KiB
Mode: 🔐 Browser · Domain: reddit.com
Commands
| Command | Description |
|---|---|
opencli reddit hot |
Hot posts from a subreddit (or frontpage if none) |
opencli reddit frontpage |
Frontpage / r/all listing |
opencli reddit home |
Personalized Best feed (requires login) |
opencli reddit popular |
Trending posts on /r/popular |
opencli reddit search |
Search posts |
opencli reddit subreddit |
Posts from a specific subreddit, with sort and time filters |
opencli reddit subreddit-info |
Subreddit metadata (subscribers, active, NSFW, created, description) |
opencli reddit read |
Read a post thread with comments |
opencli reddit user |
View a user profile |
opencli reddit user-posts |
A user's submitted posts |
opencli reddit user-comments |
A user's comments |
opencli reddit whoami |
Show the currently logged-in Reddit identity |
opencli reddit upvote |
Vote on a post or comment |
opencli reddit save |
Save / unsave a post or comment |
opencli reddit comment |
Comment on a post |
opencli reddit reply |
Reply to a comment |
opencli reddit subscribe |
Join / leave a subreddit |
opencli reddit subscribed |
List subreddits you are subscribed to |
opencli reddit saved |
List your saved items |
opencli reddit upvoted |
List your upvoted posts |
Usage Examples
# Quick start
opencli reddit hot --limit 5
# Read one subreddit
opencli reddit subreddit python --limit 10
# Subreddit metadata (subscribers / active / NSFW / created / description)
opencli reddit subreddit-info AskReddit
# Personalized Best feed (requires login)
opencli reddit home --limit 10
# Who am I logged in as?
opencli reddit whoami
# Subscribed subreddits (requires login)
opencli reddit subscribed --limit 50
# Read a post thread
opencli reddit read 1abc123 --depth 2
# Read with "more comments" expansion via /api/morechildren.json
opencli reddit read 1abc123 --depth 3 --expand-more --expand-rounds 3
# Comment on a post
opencli reddit comment 1abc123 "Great post"
# Reply to a comment
opencli reddit reply okf3s7u "Thanks for the context"
# JSON output
opencli reddit hot -f json
# Verbose mode
opencli reddit hot -v
Auth-required commands
whoami, home, subscribed, saved, upvoted, subscribe, upvote,
save, comment, and reply all require a logged-in reddit.com cookie session. When the
session is missing or expired they raise AuthRequiredError (exit code 5)
instead of silently returning empty rows.
For subreddit-info, missing / banned / private / quarantined subreddits raise
EmptyResultError (exit code 6) so the output table never contains a silent
sentinel row.
For read, deleted / quarantined / private posts (HTTP 401/403/404 on
/comments/<id>.json) also raise EmptyResultError. --expand-more follows
Reddit's "more comments" stubs by calling /api/morechildren.json up to
--expand-rounds times (default 2, max 5). If the morechildren endpoint
itself rejects the request with 401/403, that's surfaced as
AuthRequiredError because writeable/expand endpoints often require a logged-
in session even though the post listing is public.
Prerequisites
- Chrome running and logged into reddit.com
- Browser Bridge extension installed