← home · quickstart
Five commands take you from an empty repo to a supervised fleet of coding agents with crash-safe state. You need Rust 1.75+, cargo, and a git repository. That's it.
# the whole thing, top to bottom
grite init && brat init
brat mayor start
brat mayor ask "find bugs in src/ and file tasks"
brat witness run --once
brat refinery run
brat sits on top of Gritee, so install the substrate first. Then grab brat with the one-line installer or from source.
# substrate: the append-only event log
cargo install --git https://github.com/neul-labs/grite grite
# brat itself (one-line)
curl -fsSL https://raw.githubusercontent.com/neul-labs/brat/main/install.sh | bash
# ...or from source
cargo install --path crates/brat
From inside a git repository, initialise Gritee and then brat. This creates refs/grite/wal and a .brat/ config directory. Nothing touches your tracked files.
cd your-project
grite init
brat init
The Mayor is the AI orchestrator. Ask it to analyse your code and file tasks into a convoy. The demo runs the Mayor on Claude.
brat mayor start
brat mayor ask "Analyze src/ and create tasks for any bugs you find"
brat status
The Witness spawns one agent session per queued task, each in its own isolated actor directory, under bounded timeouts and TTL lock leases. Use --once to run a single pass.
brat witness run --once
# watch it live
brat status --watch
The Refinery is the merge queue. It runs your existing CI and applies your configured policy — rebase, squash, or merge — landing passing branches in order.
brat refinery run