Skip to content

`bnerd team` — Agent Teams¶

Run and manage agent teams defined in your mission repo.

See the full Agent Teams guide for concepts, recipes, and the safety model.

Synopsis¶

bnerd team <subcommand> [flags]

Subcommands¶

Subcommand	Description
`list`	List available team recipes
`describe <slug>`	Show a team recipe's members and settings
`run <slug> [prompt]`	Spawn a team and drive it headlessly
`status <team-id>`	Show a snapshot of a running team's state
`resume <team-id>`	Restore a team from disk after a crash
`cleanup <team-id>`	Shut down and archive a team

Common flags¶

Flag	Default	Description
`--mission-repo <path>`	auto-discovered	Path to the mission repo containing `orchestrator/teams/`

`run` flags¶

Flag	Default	Description
`--prompt <text>`	(empty)	Initial prompt for the team lead
`--safety <mode>`	`read-only`	Safety floor: `read-only`, `non-destructive`, `full`
`--auto-approve <policy>`	`never`	`never`, `safe`, or `all`
`--auto-skip-questions`	off	Skip `ask_question` prompts (required for CI)
`--json-events`	off	Emit JSONL event stream on stdout

Examples¶

# List recipes from the auto-discovered mission repo
bnerd team list

# Describe the pr-review recipe
bnerd team describe pr-review

# Run a PR review interactively
bnerd team run pr-review "review PR #142 in cloud/app/hq"

# Run a read-only triage in CI (no stdin, JSONL output)
bnerd team run inbox-triage "review yesterday's tickets" \
    --safety=read-only --auto-approve=safe \
    --auto-skip-questions --json-events

# Check the state of a running team
bnerd team status run-pr-review-01HX

# Resume after a crash
bnerd team resume run-cloud-app-01HX

# Clean up and archive
bnerd team cleanup run-cloud-app-01HX