TerminalAgent teams

Custom teams

A custom team is a saved team you define once and launch again later. Each team has 2 to 4 roles, and you can keep up to 20 saved teams.

Where a preset gives you a fixed pair of roles, a custom team lets you set the roles, the agent behind each role, and per-role standing instructions, then save the whole thing under a name.

Roles

A team needs at least 2 roles and holds at most 4. Each role has:

  • An agent: which CLI runs that role. You pick it with the agent picker.
  • Standing instructions: a "Behavior" note that says what the role focuses on and how it works. This is per-role behavior guidance; Coldtea still owns the collaboration flow between roles.
  • A short summary: a one-line description shown to every teammate in the team.

You can add a role until you reach 4, and remove a role until you reach the minimum of 2. At launch, each role starts in its own pane with its assigned agent, the same one-pane-per-role model described in the overview.

Rename

A team has an editable name. Rename it in place from the edit form when the name no longer fits.

Create a team

Creating a team is agent-driven. From the Agent Teams screen, open the create panel, pick an agent, and start it. That opens the agent in a new tab with a Coldtea creation prompt. The agent interviews you about the roles and instructions you want, then calls the create_agent_team tool to save the team.

Once a team exists, you edit it directly: change the agent per role, adjust the standing instructions, add or remove a role, or rename it.

Limits

  • Roles per team: 2 to 4.
  • Saved teams: up to 20. To add another once you reach 20, delete one first.

These limits are enforced when a team is saved, whether you edit it in the app or an agent saves it through the create_agent_team tool.

Next: presets for the built-in teams, or the overview for how a team launches.

On this page