staff

Staff

Local Staff CLI for routing work across agent CLIs and product workers.

The first version is CLI-first:

• Detects local worker CLIs: Codex, Claude Code, Cursor, OpenCode, Antigravity CLI, Qwen Code, Kimi Code, DeepCode.
• Uses native CLI/product harnesses instead of direct API keys by default.
• Stores request/response artifacts under .staff/sessions/.
• Keeps CLI workers in dry-run mode unless --execute is passed.

CLI Setup

npm link
staff doctor

Authenticate each worker through its native CLI or product login. The default Staff roster does not require API keys.

Claude Code Setup

Claude Code users can install the same CLI and optionally load the Claude plugin wrapper.

Local development:

npm install -g /path/to/staff
claude --plugin-dir /path/to/staff

Marketplace-style local install:

claude plugin marketplace add /path/to/staff
claude plugin install staff@staff --scope user

After install or --plugin-dir, Claude Code gets namespaced skills:

/staff:doctor
/staff:route <task>
/staff:ask <question>
/staff:review <plan-or-artifact>
/staff:tournament <task>

The plugin exposes bin/staff to Claude Code's Bash PATH while enabled, so slash commands and skills call the same CLI.

Commands

staff route "fix flaky tests in this repo"
staff auth antigravity-cli
staff ask "what is the best plan for Staff?"
staff review "review this implementation plan"
staff tournament "implement a session persistence layer"
staff ask "continue with the previous decision" --session latest
staff tournament "implement a session persistence layer" --execute
staff sessions

staff ask uses CLI/product workers as dry-run command candidates by default. Pass --execute only when you want configured non-interactive workers to run.

staff auth <staff-id> runs a worker's interactive authentication flow with live terminal input. Use it for CLIs such as Antigravity that need an OAuth code pasted into the same process.

staff tournament includes CLI/product workers. Workers are dry-runs by default; pass --execute only when you want the configured non-interactive agents to run.

Use --session latest or --continue latest to carry a previous session summary into the next Staff prompt.

External CLI Install Hints

Already installed CLIs are shown by staff doctor.

Optional installs:

scripts/install-agent-clis.sh
scripts/install-agent-clis.sh --install-missing

The helper checks all configured CLI workers. It installs npm-backed workers only when --install-missing is passed: Codex, Claude Code, OpenCode, Qwen Code, and DeepCode.

Product-specific workers are reported but not installed automatically:

• Antigravity CLI: run curl -fsSL https://antigravity.google/cli/install.sh | bash, or pass --include-shell-installers.
• Cursor: install Cursor and enable its shell command.
• Kimi Code: run curl -L code.kimi.com/install.sh | bash, or pass --include-shell-installers.
• Manus: no public CLI is configured yet; use a manual/product bridge.

Kimi/Qwen/DeepCode credentials are configured in their own tools.

Configuration

Edit staff.config.json to change presets, model IDs, provider URLs, and CLI run templates.

The important split is:

• CLI/product workers are the default for advice, judging, structured comparisons, repo work, and long-running agent sessions.