Installation

Install reddit from a release, with go install, from a package manager, or as a container.

Prebuilt binaries

Every release carries archives for Linux, macOS, Windows, and FreeBSD on amd64 and arm64, plus deb, rpm, and apk packages for Linux. Download, unpack, put reddit on your PATH, done. The checksums.txt on each release is signed with keyless cosign, and SBOMs ship alongside, if you want to verify before running.

With Go

go install github.com/tamnd/reddit-cli/cmd/reddit@latest

That puts reddit in $(go env GOPATH)/bin, which is ~/go/bin unless you moved it. Make sure that directory is on your PATH.

Homebrew

brew install --cask tamnd/tap/reddit

Scoop

scoop bucket add tamnd https://github.com/tamnd/scoop-bucket
scoop install reddit

Container image

The multi-arch image is on GHCR:

docker run --rm ghcr.io/tamnd/reddit:0.1.0 posts golang

From source

git clone https://github.com/tamnd/reddit-cli
cd reddit-cli
make build        # produces ./bin/reddit
./bin/reddit version

Requirements

Go 1.26 or later to build. The released binary has no Go requirement.

That is the whole list. The binary is pure Go (CGO_ENABLED=0), so there is no config file to write, no database to provision, and nothing to link against.

Checking the install

reddit version

prints the version and exits. Then confirm it can reach Reddit:

reddit posts golang -n 3

should print a few posts from r/golang. If you see them, you are ready for the quick start.