Reddit CLI
Read Reddit using your session cookies. No API key needed.
Quick start
bash
reddit-cli posts programming 10 # Get 10 hot posts reddit-cli posts gaming 5 top # Get top 5 posts 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
bash
reddit-cli posts <subreddit> [limit] [sort]
- •limit: number of posts (default: 10)
- •sort: hot, new, top, rising (default: hot)
Search Reddit
bash
reddit-cli search <query> [--sub <subreddit>] [limit]
Get subreddit info
bash
reddit-cli info <subreddit>
Check connection
bash
reddit-cli check
Environment
Set these in ~/.bashrc:
bash
export REDDIT_SESSION="your_reddit_session_cookie" export TOKEN_V2="your_token_v2_cookie" # optional
Getting cookies
- •Go to reddit.com (logged in)
- •DevTools (F12) → Application → Cookies → reddit.com
- •Copy
reddit_sessionvalue - •Optionally copy
token_v2value
Notes
- •Cookies expire, you may need to refresh them periodically
- •Respects Reddit's rate limits
- •For personal use only