> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pentagon.run/llms.txt
> Use this file to discover all available pages before exploring further.

# The Spatial Canvas

> Your visual workspace where every agent has a place

# 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`

The canvas is infinite in all directions. Arrange agents however makes sense for your project.

## 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](/agents/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

Drag agents into a team region to assign them. Group agents by function — engineering, ops, research. Shared context, clear boundaries.

Team regions are color-coded so you can visually distinguish groups at a glance.

## 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       |

<Card title="Next: Panels" icon="columns-3" href="/workspace/panels">
  Learn about the sidebar and detail panels.
</Card>
