# Grid mode

> See your agents side by side in a tidy, resizable grid — and switch back to the canvas any time.

Source: https://docs.neurosquad.ai/en/canvas/grid-mode

The canvas is great for building a squad: place cards anywhere, draw arrows, group them. When the
squad is just *working*, you often want the opposite — every agent's terminal on screen at once,
neatly lined up. That's **Grid mode**.

Switch with the **Canvas / Grid** toggle in the title bar, or press `Ctrl` `Shift` `G`
(`⌘` `Shift` `G` on a Mac). Each workspace remembers its own mode.

> Switching never restarts anything. The same terminals move between the canvas and the grid —
> sessions keep running, and what's on screen stays exactly where it was.

## Layouts

The bar above the grid picks a layout:

| Layout | What you get |
| --- | --- |
| All tiles | Every agent, in a tidy grid that fits your window |
| One tile | One agent fills the area |
| Two side by side | Two agents, left and right |
| 2 × 2 | Four agents |
| 3 × 2 | Six agents |
| Focus and stack | One large agent on the left, up to three stacked on the right |

When a layout has fewer places than you have agents, the rest wait in the **Not in view** strip under
the grid. Click one to bring it in — it takes the place of the tile you were using.

Tiles never get too small to read: with many agents in a small window, the grid scrolls instead of
shrinking them. The **add** button in the bar adds an agent or card without leaving the grid (in a
group, the new card joins that group).

## Arrange the tiles

- **Resize:** drag the thin line between two tiles. Double-click the line to even them out again.
- **Tidy:** makes every tile in the current layout the same size.
- **Swap:** drag a tile by its header (its name works too) onto another tile.
- **Maximize:** the expand button in a tile's header (or `Ctrl` `Alt` `Enter`)
lets one agent fill the grid; press it again to go back.
- **Move between tiles:** `Ctrl` `Alt` and the arrow keys — the terminal you land on
is ready to type in.
- **Undo:** `Ctrl` `Z` steps back through layout changes in the grid (outside a terminal).

## What's connected to what

Under each tile, a row of chips shows the tile's [arrows](https://docs.neurosquad.ai/en/canvas/arrows): the agents it leads or
reports to, and the cards it uses — a note, a browser, an MCP server, a skill, a plugin. The small
arrow on each chip shows the direction.

- Hover a tile and the tiles it's wired to light up.
- Click a chip of another agent to jump to that agent's tile.
- Click a chip of any other card to see what it is and what it's connected to, with a
**Show on canvas** button.

Arrows are drawn and removed on the canvas; the grid shows them.

## Filters

- **Only agents** hides terminals, notes, browsers and every other card, leaving just the AI agents.
- **Cards** shows or hides the side strip with everything that isn't a tile — notes, to-dos, the
browser, MCP and skill cards. Hover a card there to see which tiles it's wired to; collapse the strip
to a thin rail of icons.
- The **Squad** button opens or closes the Squad panel on the right.

The grid follows the sidebar: pick a group and you see only that group's agents.