Overview
An agent team launches several agents at once, one pane per role. Instead of one agent working a problem alone, a small group of agents works it together, each with a defined job.
Coldtea owns the collaboration scaffolding: how the roles hand work back and forth. You choose the roles, the agent behind each role, and any standing instructions.
When to use a team
Use a team when the work splits cleanly into roles that talk to each other:
- One agent writes code while another watches and steers.
- One agent writes a failing test and hands over; another makes it pass.
- One agent writes a chunk and another reviews it before moving on.
Use a single brew when the job is one stream of work that does not need a second role.
Open Agent Teams
Press Cmd+Shift+A (Ctrl+Shift+A on Windows and Linux) to toggle the Agent Teams screen. You can also reach it from the pane quick actions and the Brews sidebar.
From there you pick a team, either a built-in preset or one of your saved teams, and start it.
Launch a team
Choosing a team and pressing "Launch Session" opens one pane per role. Each role starts in its own pane with the agent you assigned to it, so you can watch every participant at once and follow the handoffs between them.
At launch, Coldtea resolves each role's agent against the agents you have installed. If a role points at an agent you do not have, Coldtea clears that assignment so you can pick an installed agent instead.
Because a team runs several agents in the same checkout, consider giving the work its own worktree when the team is going to edit code. That keeps a team's branch from stepping on other work.
Next: presets for the built-in teams, or custom teams to save your own.