Installation

macOS and Linux are supported. The Homebrew release is a self-contained binary, while the npm and Bun package requires Bun at runtime.

Homebrew (prebuilt binary)

The fastest path. Installs a standalone staff binary:

brew install staffreview/tap/staff
staff --version

npm or Bun (GitHub Packages)

The @staffreview/staff package is published to GitHub Packages. Configure the @staffreview scope once in ~/.npmrc, using a GitHub personal access token (classic) with read:packages permission:

@staffreview:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_PACKAGES_TOKEN}

Export the token in your shell, then install with either npm or Bun:

export GITHUB_PACKAGES_TOKEN=your_classic_pat
npm install --global @staffreview/staff
# or: bun install --global @staffreview/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 Homebrew binary.
• Bun if you install from GitHub Packages, 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-copy, /staff-document, and /staff-docs when working with GitHub PRs. It must be installed and authenticated (gh auth login) before those skills can read PR comments.