Installation

macOS and Linux are supported. All you need on the machine is git — the released binary is self-contained (it bundles its own runtime), so there’s nothing else to install to run it.

Homebrew (prebuilt binary)

The fastest path. Installs a standalone staff binary:

brew install staffreview/tap/staff
staff --version

From source

Building (or running) from source additionally needs Bun:

git clone https://github.com/staffreview/staffreview.git
cd staffreview
bun install
cd apps/staffreview && bun run build:binary   # compiles a standalone ./dist/staff

# put it on your PATH
ln -s "$PWD/dist/staff" ~/.local/bin/staff
staff --version

Prefer not to build? Run straight from source:

bun run apps/staffreview/src/cli.ts <args>

Requirements

• git and macOS or Linux — that’s all you need to run the prebuilt binary.
• Bun only if you build or run from source.
• An AI coding agent for the automated review. Claude Code works out of the box; any harness that can read a SKILL.md and run shell commands works too.
• The GitHub CLI (gh) — optional, and only for /staff-docs, which mines your merged PRs for review lessons. It must be installed and authenticated (gh auth login); without it, /staff-docs just skips PRs and still works on your local review history.