TeamCLI · VERSION 0.5.5

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 team
No 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

team config edit
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-quota

The plan

team down --dry-run — every command a stop would run, and what it leaves alone

Terminal
 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 0

The reading

team status — the seats, and the repair for each difference

Terminal
 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 1

The 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.