jackwener--opencli/docs/adapters/browser/reddit.md

Reddit

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