3.2k Downloads
Overview
A command-line interface (CLI) tool to read Reddit content using your logged-in web session cookies instead of the official Reddit API, allowing authenticated, read-only access to posts, search results, and subreddit information.
Key Advantages
1.No Reddit API key or OAuth app setup required; works by reusing your existing logged-in browser session cookies.
2.Simple CLI commands for common read-only tasks: listing posts, searching Reddit or a specific subreddit, checking subreddit info, and testing connectivity.
3.Supports basic sorting (hot, new, top, rising) and limiting of results, making it useful for quick terminal-based browsing or scripting.
4.Configuration is straightforward: just set environment variables for cookies (REDDIT_SESSION and optional TOKEN_V2) in your shell profile.
5.Designed to respect Reddit’s rate limits and intended primarily for personal use, reducing the likelihood of accidental abusive traffic.
Use Cases
- Terminal-based browsing of subreddit posts without opening a browser, e.g., quickly viewing hot posts from programming or gaming.
- Filtering and searching Reddit content from scripts or shell pipelines, such as searching for specific topics across Reddit or within a single subreddit.
- Gathering basic subreddit info (e.g., AskReddit) as part of automation or monitoring scripts that run in a terminal environment.
- Using authenticated Reddit access in environments where setting up API keys or OAuth credentials is undesirable or not possible.
- Personal productivity workflows where a user wants quick, keyboard-only Reddit access alongside other CLI tools.
Evaluation Scores
6.8
/ 10
Reliability
6.0
Functionality
7.5
Usability
7.0
Safety
5.5
Performance
8.0
Compatibility
8.0
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
6.8/103/19/2026▼
OS: linux-arm64LLM: google/gemini-3.1-pro-preview
**Judgment:** A practical, lightweight Reddit CLI for power users who are comfortable handling browser cookies and environment variables. It provides convenient, read-only access to posts, search, and subreddit info directly from the terminal without needing API credentials.
**Key Risks and Limitations:**
- **Account security risk:** Users must manually copy their `reddit_session` (and optionally `token_v2`) cookies and store them in environment variables. If the machine or shell config is compromised, attackers could hijack the Reddit account.
- **Cookie expiry and breakage:** Cookies expire regularly, so the tool will periodically stop working until the user refreshes the cookie. Reddit web changes could also break the underlying behavior since it relies on session cookies rather than a stable public API.
- **Potential ToS concerns:** While labeled for "personal use" and rate-limit-aware, using web session cookies for scripted access may be at odds with Reddit’s terms or expectations for automated use.
**Recommended Scenarios:**
- Individual, technically proficient users who:
- Use a personal, reasonably secure machine.
- Are comfortable with browser DevTools and editing shell configs.
- Want quick, API-free Reddit access for reading, searching, or integrating Reddit content into command-line workflows.
- Not recommended on shared or insecure systems, or for large-scale data collection or any scenario requiring strict adherence to Reddit’s official API policies.
Comments (0)
No comments yet. Be the first!