Reddit CLI

Reddit CLI

Read Reddit using your session cookies. No API key needed.

Quick start

reddit-cli posts programming 10       # Get 10 hot posts
reddit-cli posts gaming 5 top         # Get top 5 posts
reddit-cli post 1rvaymh               # Get full post by ID
reddit-cli post https://reddit.com/r/openclaw/comments/1rvaymh/...  # Get full post by URL
reddit-cli search "python tutorial"   # Search all Reddit
reddit-cli search "help" --sub linux  # Search in subreddit
reddit-cli info AskReddit             # Subreddit info
reddit-cli check                      # Test connection

Commands

Get posts from subreddit

reddit-cli posts <subreddit> [limit] [sort]

• limit: number of posts (default: 10)
• sort: hot, new, top, rising (default: hot)

Get full post content

reddit-cli post <url-or-id>

• Supports full URLs: https://reddit.com/r/subreddit/comments/POSTID/...
• Supports post IDs: 1rvaymh
• Supports permalinks: /r/subreddit/comments/POSTID/...

Returns the complete post including title, author, score, and full selftext content.

Search Reddit

reddit-cli search <query> [--sub <subreddit>] [limit]

Get subreddit info

reddit-cli info <subreddit>

Check connection

reddit-cli check

Environment

Set these in ~/.bashrc:

export REDDIT_SESSION="your_reddit_session_cookie"
export TOKEN_V2="your_token_v2_cookie"  # optional

Getting cookies

1. Go to reddit.com (logged in)
2. DevTools (F12) → Application → Cookies → reddit.com
3. Copy reddit_session value
4. Optionally copy token_v2 value

Notes

• Cookies expire, you may need to refresh them periodically
• Respects Reddit's rate limits
• For personal use only