A command-line tool for browsing Reddit without requiring an API key
Project description
Reddit CLI
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.
Why Reddit CLI?
- 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
Features
- 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
Quick Start
# 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 Overview
| 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 |
Browse Options
--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
Development
# 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 python
Contributing
Contributions are welcome! Feel free to open issues or submit PRs.
License
MIT - See LICENSE for details.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file better_reddit_cli-0.9.0.tar.gz.
File metadata
- Download URL: better_reddit_cli-0.9.0.tar.gz
- Upload date:
- Size: 257.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3b8b1a0bed6873676abc624206599df6db00476aca665e508faceaa03dfdc722
|
|
| MD5 |
b3c9d4fb5e5cb062a56860e12f8cc10b
|
|
| BLAKE2b-256 |
b8a712594b968a7ac41e5a651a06ef430363c66d191c111a69595bed5627449c
|
File details
Details for the file better_reddit_cli-0.9.0-py3-none-any.whl.
File metadata
- Download URL: better_reddit_cli-0.9.0-py3-none-any.whl
- Upload date:
- Size: 30.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
84c4b299739481773b278e88b835244579036db299baa825c11e8f282750a149
|
|
| MD5 |
52b4d001e83396eea410c40af47d4265
|
|
| BLAKE2b-256 |
b3d297fe6c755a911a480ea3b6911335f9f466d3806d5584f76aac836b181ff9
|
