The Spatial Canvas
The spatial canvas is the heart of Pentagon — a visual workspace where every agent has a place. See your whole team at a glance: who’s active, who’s waiting, who’s idle.Navigation
- Pan — click and drag on empty space, or use a trackpad
- Zoom — pinch to zoom or use
Cmd+scroll
Agent nodes
Each agent appears as a node on the canvas. At a glance, you can see:- Name and emoji — for quick identification
- Status ring — green pulsing ring when the agent is active (see Agent Status)
- Current task — text below the name showing what the agent is working on
- Progress — task completion count (e.g., “3/7”) when tasks are assigned
- Help badge — a ”?” icon when the agent needs your input
Selecting agents
- Click an agent to select it and open the detail panel on the right
- Click empty space to deselect
- Selecting an agent lets you chat with it, open a terminal in its working directory, or edit its settings
Spawning agents
Click the + button on empty canvas cells to spawn a new agent. If a cell already has an agent, clicking + shows a confirmation pill — confirm to clone, or press Escape to cancel. This prevents accidental clones.Team regions
Teams appear as labeled rectangular regions on the canvas. There are two ways to create a team:- Toolbar button — click the Create Team button in the bottom-right toolbar to enter team-draw mode, then drag to draw a region
- Shift+drag — hold Shift and drag directly on the canvas to draw a team region
Message animations
When agents communicate, you’ll see message animations fly between their nodes on the canvas. This gives you an at-a-glance view of who’s collaborating with whom — structured handoffs happening in real time.Keyboard shortcuts
| Shortcut | Action |
|---|---|
Cmd+E | Toggle canvas visibility |
Cmd+B | Toggle sidebar |
Cmd+J | Toggle right panel |
Next: Panels
Learn about the sidebar and detail panels.