The Canvas
Navigate and organize the infinite workspace where every AgentGrid pane lives.
Each space has an infinite 2D canvas. Agent panes, terminals, browsers, notes, and other tools can be arranged freely, while AgentGrid remembers the camera position and zoom for that space.
Panning and zooming
The defaults follow each platform and can be rebound in Settings.
- Pan from anywhere - hold OptionCtrl, then drag, middle-click, or scroll. This works over live panes, including browsers.
- Zoom under the cursor - CmdScrollCtrlScroll.
- Trackpad zoom - pinch on any platform.
- Zoom in or out - Cmd=Ctrl= / Cmd-Ctrl-.
- Zoom to the selected pane or all panes - CmdShift2CtrlShift2.
Space is ordinary input, so it reaches terminals and editors instead of activating canvas pan.
Inside a browser pane, hold CtrlAlt while pinching to send the gesture to the page instead of zooming the canvas.
Spaces are tabs
A space owns its canvas, pane list, camera state, and project folder.
- New space - CmdTCtrlT.
- Switch space - click a tab or use the platform tab-navigation shortcut.
- Reorder spaces - drag tabs left or right.
- Close space - CmdWCtrlW.
- Reopen the last closed space - CmdShiftTCtrlShiftT.
Only the active space listens for canvas shortcuts.
Workspace explorer
The left sidebar lists the panes in the current space.
- Toggle it with Cmd\Ctrl\.
- Search titles and metadata with CmdFCtrlF.
- Select a row to center its pane on the canvas.
- Right-click the explorer and choose Collapse all or Expand all to manage a large hierarchy.
- Rename the selected pane with F2F2. F2 works for agent, worker, terminal, browser, note, code, and other renameable panes.
Folded and expanded groups are remembered per project. Activity dots identify panes and space tabs that are working or running, so background work remains visible even when another space is active.
View history
AgentGrid records settled camera views that contain panes. Use view history to return to a cluster you just left without searching the minimap again:
| Platform | Back | Forward |
|---|---|---|
| macOS | Ctrl-Ctrl- | CtrlShift-CtrlShift- |
| Windows / Linux | Alt←Alt← | Alt→Alt→ |
History is scoped to the project and ignores blank camera positions. Both commands can be rebound under Settings -> Shortcuts.
Minimap, filtering, and organization
The minimap shows the camera's position in the larger workspace. The pane counter updates as panes are added or removed. Use the canvas filter menu (CmdShiftFCtrlShiftF) to dim panes that do not match a type, relationship, or activity filter without moving them. Zoom-to-selection centers the selected group, and ordinary zoom stays centered under the pointer.
Auto-organize reflows the active space into a tidy grid while preserving master/worker relationships. This is useful after a large parallel run.
Appearance
Choose a theme under Settings -> Appearance. Light mode uses a dedicated terminal ANSI palette for readable output on light surfaces, and your theme persists across restarts.
A typical navigation loop
- Open a space and bind a project folder.
- Spawn an agent with CmdNCtrlN.
- Hold OptionCtrl and drag to move the camera.
- Use the explorer to jump to a specific worker.
- Press CmdShift2CtrlShift2 to bring the relevant panes back into view.
For pane types and spawn behavior, see Panes. For every binding, see Keyboard shortcuts.