Skip to main content

​
Teams

Teams let you group related agents together — visually on the spatial canvas and organizationally for collaboration. Group agents by function. Engineering, ops, research. Shared context, clear boundaries.

​
Creating a team

There are two ways to start:
  • Click the Create Team button in the canvas toolbar (bottom-right)
  • Or hold Shift on the canvas
Either way, the canvas enters team-draw mode and the cursor changes to a crosshair. Then:
  1. Drag to draw a rectangular region — you’ll see a live preview as you drag
  2. Release to finalize the area — a dialog appears where you name the team, pick a color, and optionally add an emoji
  3. Click Create Team — the team region appears on the canvas

​
Adding agents to a team

  • Drag an agent’s node into a team region on the canvas
  • Or assign a team when spawning a new agent
  • Or select an agent, open Settings, and change its team assignment
Agents inside a team region are visually grouped, making it easy to see which agents belong together.

​
Team colors

Each team gets a distinct color so you can tell groups apart at a glance. Colors are assigned automatically but can be customized in the creation dialog or team settings.

​
Why use teams?

Visual clarity — On a canvas with 10+ agents, teams turn chaos into structure. You immediately see your frontend group, your backend group, your infra group. Communication context — When agents are on a team, they understand their organizational context. A backend agent on the “API Team” knows to coordinate with its teammates on API-related decisions. Scalability — As you add more agents, teams prevent the canvas from becoming an unreadable sea of nodes. Pentagon gives you the building blocks. Design your own hierarchy — flat, layered, or anything in between.

Next: Roles

Categorize agents by specialty with roles.