Reddit CLI Logo

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.

Metadata

Release files for better-reddit-cli 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for better-reddit-cli 0.9.0
File	Size	Uploaded
better_reddit_cli-0.9.0.tar.gz	257.1 kB	Apr 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for better-reddit-cli 0.9.0
File	Interpreter	ABI	Platform	Reset
better_reddit_cli-0.9.0-py3-none-any.whl 30.3 kB Apr 10, 2026	Python 3	none	any	Details

Total release size: 287.4 kB

Release files / better_reddit_cli-0.9.0.tar.gz

Download URL	better_reddit_cli-0.9.0.tar.gz
Size	257.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`3b8b1a0bed6873676abc624206599df6db00476aca665e508faceaa03dfdc722`
BLAKE2b-256 checksum How to use checksums	`b8a712594b968a7ac41e5a651a06ef430363c66d191c111a69595bed5627449c`
Upload date	Apr 10, 2026
Uploaded using Trusted Publishing? What is 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}`

Release files / better_reddit_cli-0.9.0-py3-none-any.whl

Download URL	better_reddit_cli-0.9.0-py3-none-any.whl
Size	30.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`84c4b299739481773b278e88b835244579036db299baa825c11e8f282750a149`
BLAKE2b-256 checksum How to use checksums	`b3d297fe6c755a911a480ea3b6911335f9f466d3806d5584f76aac836b181ff9`
Upload date	Apr 10, 2026
Uploaded using Trusted Publishing? What is 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}`