Reddit Cli

Reddit CLI using cookies for authentication. Read posts, search, and get subreddit info.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install 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 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)

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

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

Notes

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