Agent GridAgent Grid Docs
Core Concepts

The Canvas

The infinite, pan-and-zoom workspace where every Agent Grid pane lives.

The canvas is the infinite 2D surface each space draws onto. Panes — Claude sessions, terminals, browsers, notes — sit on it freely, and you fly between them by panning and zooming the camera.

Panning and zooming

The canvas behaves like a Figma board. The defaults are rebindable in Settings.

  • Pan — hold SpaceSpace, then click and drag.
  • Zoom under the cursorCmdScrollCtrlScroll.
  • Zoom in / out from the keyboardCmd=Ctrl= / Cmd-Ctrl-.
  • Zoom to fit all panesCmdShift2CtrlShift2.

When the cursor is inside a browser pane, the canvas does not zoom. CtrlScrollAltScroll is forwarded into the browser as pinch-zoom instead.

Spaces are tabs along the title bar

A space is a tab. Each space owns its own canvas, its own pane list, and its own project folder. The title bar at the top of the window lists every open space.

  • New spaceCmdTCtrlT.
  • Switch space — click a tab.
  • Close space — close the tab.

Only the active space's canvas listens for shortcuts. Background canvases for inactive spaces are paused — they will not intercept CmdNCtrlN, Cmd1Ctrl1, or any other binding while you're looking at a different tab.

See Spaces and project folders for how a space binds to a folder on disk.

Workspace explorer sidebar

The left-rail workspace explorer lists every pane in the current space so you can jump straight to it instead of hunting on the canvas.

  • Toggle the sidebarCmd\Ctrl\.
  • Search panesCmdFCtrlF with the sidebar open. Search matches pane titles and metadata keywords, so you can find a pane by what's in it, not just what it's called.
  • Quick filter — the Show active panes filter narrows the list to just the panes that are currently doing something.

Selecting a pane in the explorer pans the camera to it.

Minimap and the pane counter

A minimap in the corner shows the camera's location in the wider canvas, alongside a counter of how many panes live in the current space. Both update live as you pan, zoom, and spawn.

Auto-organize

The auto-organize action re-flows the panes in the active space into a tidy grid, preserving relative order and grouping master / worker relationships. Use it when a long orchestration session has scattered panes across the canvas and you want a clean view to navigate from.

Moving around: putting it together

A typical loop looks like:

  1. CmdTCtrlT to open a new space, drag a project folder onto it.
  2. Cmd1Ctrl1 to spawn a Claude pane at the cursor.
  3. Hold SpaceSpace and drag to move the camera.
  4. Cmd\Ctrl\ to pop the explorer and jump to a specific worker pane.
  5. CmdShift2CtrlShift2 to zoom out and see the whole grid.

For the full pane catalog and spawn shortcuts, see Panes.

On this page