Installation

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

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

Quick install (any platform)

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

Detects your OS and arch, downloads the matching 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).

The script reads two environment variables:

Var	Default	Purpose
`TOK0_VERSION`	`latest`	Pin to a specific release tag.
`TOK0_INSTALL_DIR`	`/usr/local/bin`	Where the binary lands.

Pinning a version into your home dir:

TOK0_VERSION=0.1.0 TOK0_INSTALL_DIR="$HOME/.local/bin" \
  curl -fsSL https://tok0.dev/install.sh | sh

The script prefers glibc on Linux and falls back to musl on Alpine and other musl-based systems.

macOS — Homebrew

brew install tok0

No tap. The formula updates 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

tok0-bin 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. Needs rustup update stable (1.95+).

Note

cargo install produces a 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 for containerized agent runtimes.

From source

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

There’s also make release as a shortcut.

Verifying

tok0 --version
tok0 doctor

tok0 doctor checks PATH wiring, config dir permissions, AI tool detection, and hook signatures.

Updating

For binary installs:

tok0 update

For package-manager installs, use the manager:

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

Uninstalling

Remove the hooks:
```
tok0 init --remove
```
Remove the binary the same way you installed it (brew uninstall tok0, cargo uninstall tok0, etc.).
Optional — wipe config and cache: rm -rf ~/.config/tok0 ~/.cache/tok0.