Installation

Prebuilt binaries

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

With Go

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

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

From source

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

The binary is pure Go and builds with CGO_ENABLED=0, so there is nothing to link against and nothing to install alongside it.

Container image

docker run --rm ghcr.io/tamnd/arxiv:latest --help

The image is multi-arch. If you want the cache to survive between runs, mount a volume at the data directory and set --data-dir to it.

Checking the install

arxiv version

prints the version, the commit and the build date.

arxiv planes

prints the two rate limits and the date they were measured, and makes no request while doing it, so it is a safe first command.