03 START APR 2026

Installation

Every supported install path for tok0 — Homebrew, shell script, Cargo, Scoop, Chocolatey, Snap, Docker, and source build.

tok0 is a single static Rust binary, ~8 MB stripped, with no runtime dependencies. Pick whichever package manager you already use.

Quick install (any platform)

curl -fsSL https://tok0.dev/install.sh | sh

The script detects your OS and architecture, downloads the matching pre-built binary from GitHub Releases, verifies its checksum, and drops it into /usr/local/bin/tok0 (or ~/.local/bin/tok0 if /usr/local isn’t writable).

macOS — Homebrew

brew install tok0

Tap-less. The Homebrew formula is updated automatically on every release.

Linux

Debian / Ubuntu

curl -fsSLO https://github.com/prxm-labs/tok0/releases/latest/download/tok0_amd64.deb
sudo dpkg -i tok0_amd64.deb

Snap

sudo snap install tok0

Arch / AUR

The tok0-bin package tracks releases. Install with your favorite AUR helper.

Windows

Scoop

scoop bucket add prxm-labs https://github.com/prxm-labs/scoop-bucket
scoop install tok0

Chocolatey

choco install tok0

Cargo (any platform)

cargo install tok0

Builds from source. Requires rustup update stable (1.95+).

Note

cargo install produces a debug-symbol-stripped release binary identical to the published artifact. CI gates the same build.

Docker

docker pull ghcr.io/prxm-labs/tok0:latest
docker run --rm -i ghcr.io/prxm-labs/tok0:latest tok0 --version

Useful if you’re integrating tok0 into a containerized agent runtime.

From source

git clone https://github.com/prxm-labs/tok0
cd tok0/apps/cli
cargo build --release
./target/release/tok0 --version

The repo also has a Makefile shortcut: make release.

Verifying the install

tok0 --version
tok0 doctor

tok0 doctor runs a battery of sanity checks: PATH wiring, config dir permissions, AI tool detection, hook signatures.

Updating

tok0 ships with a self-update checker for binary installs:

tok0 update

For package-manager installs, use the manager’s update command:

brew upgrade tok0          # macOS
sudo apt upgrade tok0      # Debian/Ubuntu
scoop update tok0          # Windows
cargo install tok0 --force # Cargo

Uninstalling

Remove the registered hooks:
```
tok0 init --remove
```
Remove the binary with whatever installed it (brew uninstall tok0, cargo uninstall tok0, etc.).
(Optional) Remove the config + cache: rm -rf ~/.config/tok0 ~/.cache/tok0.