Ship with a team that
never sleeps.
Specialized agents, from any lab.
bun add -g team npm install -g team pnpm add -g team yarn global add teamNo runtime dependenciesNode 22 or laterMIT
01
Any model, in any seat
Put the right specialized agent — from any lab — on each role, and swap it without rewriting the team.
02
Safe by design
Clear line between what agents decide and what only you can: the team moves fast inside its envelope and stops at the edge.
03
The watch tells you
Reports idle seats and nudges the operator.
One file, a plan, and a reading
Every block below is a tested page of the command reference, shown as it is there.
The team
team config edit — the project's whole team, as YAML
format: 1
project: beacon
coordinator: claude-keeper
operator: claude-keeper
trust:
- ~/.config/team/lobby
- ~/Code/beacon
workspace:
mode: shared
seats:
- role: coordinator
name: claude-keeper
label: coordinator
cli: claude-code
vendor: anthropic
model: Claude Opus
version: "5.5"
launch: claude --model claude-opus-5-5
- role: implementer
name: claude-beacon
label: implementer
cli: claude-code
vendor: anthropic
model: Claude Opus
version: "5.5"
launch: claude --model claude-opus-5-5
budgets:
accounts:
openai:
kind: subscription
reserve: 20%
sources: [check, status_line]
check: examples/checks/codex-quotaThe plan
team down --dry-run — every command a stop would run, and what it leaves alone
team down --dry-run ; echo "exit $?"
watch: its pid is only in the state; left running
+ herdr --session beacon pane run w1:p1 /exit
wait until claude-keeper's pane is back at its shell (30 s at most); on a time-out it is left as it is
+ herdr --session beacon workspace close w1
+ herdr --session beacon pane run w2:p1 /exit
wait until claude-beacon's pane is back at its shell (30 s at most); on a time-out it is left as it is
+ herdr --session beacon workspace close w2
+ herdr session stop beacon
(stopped, then cleared: the session this run stopped, so a later `up` starts from the beginning)
dry run: nothing was run
exit 0The reading
team status — the seats, and the repair for each difference
team status ; echo "exit $?"
team beacon, session "beacon"
SEAT STATE MODEL PANE REACH
claude-keeper missing Claude Opus 5.5 - typed
claude-beacon working Claude Opus 5.5 w1:p1 typed
budgets:
openai session left 40% used 60% resets in 44m - read 2m ago check fresh
openai daily left 70% used 30% resets unknown claude-beacon last seen 40m ago status line (fallback) stale
openai weekly left 5% used 95% resets in 44m claude-beacon changed 2m ago status line (fallback) fresh, inside reserve 20%
note: watch: pane w9:p1, pid 4242, last heartbeat 0s ago
difference: claude-keeper is in the file and is not running
repair: team restart claude-keeper
who: the team's lead
1 difference
exit 1The file and the reading come from the team status page, and the plan from the team down page, each of which runs it against its own fixture team.