Installation

Homebrew

Homebrew is the recommended installation path. The tap builds from source and works on Apple Silicon and Intel Macs.

brew install chungchihhan/tap/tracce

Upgrade an existing installation with:

brew upgrade tracce

Cargo

If you already have Rust installed:

cargo install --git https://github.com/chungchihhan/tracce

Build from source

git clone https://github.com/chungchihhan/tracce
cd tracce
cargo build --release
sudo cp target/release/tracce /usr/local/bin/

macOS permission

Your terminal needs Full Disk Access so the event stream can include paths that macOS protects. Open System Settings → Privacy & Security → Full Disk Access, enable your terminal, then restart it.

Verify

tracce --help

Then start your first recording:

tracce codex

Open another terminal and run tracce view. See commands for every launch mode.