Browse Reddit from your terminal. No API key, no authentication, no hassle.
Explore subreddits, dive into discussions, and discover trending content - all from a sleek command-line interface.
- Zero setup - No API key needed, just install and go
- Blazing fast - Async HTTP powered by httpx
- Explore deeply - Pagination, sorting, and threaded comments
- Clean output - Readable formatting right in your terminal
- Browse subreddits with 6 sorting modes (hot, new, top, rising, controversial, gilded)
- View posts with full metadata
- Threaded comment display with depth control
- Pagination support for infinite scrolling
- Subreddit info, rules, and moderator discovery
- 100% type-annotated Python
# Install
uv add better-reddit-cli
# Browse the frontpage
reddit
# Explore a subreddit
reddit browse python --limit 10
# View a post and its comments
reddit view t3_abc123
reddit comments t3_abc123 --depth 3
# Discover subreddits
reddit subreddits --sort subscribers
reddit subreddit python --rules| Command | Description |
|---|---|
reddit |
Frontpage (hot posts) |
reddit browse <sub> |
Browse a subreddit |
reddit view <id> |
View a post |
reddit comments <id> |
View post comments |
reddit subreddit <name> |
Subreddit info |
reddit subreddits |
List popular subreddits |
--sort hot|new|top|rising|controversial|gilded
--limit <n> Number of posts (max 100)
--period day|week|month|year|all
--after <id> Next page
--before <id> Previous page
# Clone and install
git clone https://github.com/AliiiBenn/reddit-cli.git
cd reddit-cli
uv sync
# Run tests
uv run pytest
# Lint and type-check
uv run ruff check .
uv run mypy reddit_cli
# Try it out
uv run reddit browse pythonContributions are welcome! Feel free to open issues or submit PRs.
MIT - See LICENSE for details.