Installation

Quick install

Homebrew

brew tap kannandreams/homebrew-tuff
brew install tuff

Requires Homebrew.

curl

curl -fsSL https://raw.githubusercontent.com/kannandreams/tuff/main/install.sh | sh

Downloads the latest release binary for your OS and architecture.

cargo

cargo install tuffcli

Builds from source. Requires Rust and Cargo.

pip / uv

pip install tuffcli
uv tool install tuffcli

Installs a prebuilt wheel for supported macOS and Linux platforms. The distribution is named tuffcli; the installed command remains tuff.

Build from source

git clone https://github.com/kannandreams/tuff
cd tuff
cargo build -p tuffcli --release
./target/release/tuff --version

Clone and build locally.

Verify

tuff --version
tuff

Tuff Console container image

Tuff Console, the self-hosted server for project reports, is also published as a container image for linux/amd64 and linux/arm64. It holds the same tuff binary as the release, so a server that only runs the console does not need the CLI installed:

docker pull ghcr.io/kannandreams/tuff-console:latest

Run in a container covers the tags, creating a publish key, starting the console, trying it with sample data, and verifying the image signature.

Requirements

• Rust: cargo and build methods use it directly. curl and brew methods install prebuilt binaries, available for macOS (Apple silicon and Intel) and Linux (x86-64 and ARM64).
• Git: required for tuff add with git-backed capabilities.

Installed Files

• /usr/local/bin/tuff (curl/brew methods)
• user cache directory: disposable verified capability trees
• project root: tuff.lock and optional tuff.config.json