Panes
The pane types AgentGrid places on the canvas and how to spawn, rename, move, and restore them.
A pane is a movable unit on the canvas. Every agent, terminal, browser, note, title, editor, source-control view, image, and video is a pane with its own position, size, and state.
Pane catalog
| Shortcut | Pane | What it opens |
|---|---|---|
| Cmd1Ctrl1 through Cmd3Ctrl3 | AI Agents | The first three enabled harnesses, in the order shown under Settings -> Agents. |
| Cmd4Ctrl4 | Terminal | A PTY-backed shell in the space's project folder. |
| Cmd5Ctrl5 | Code Editor | An embedded VS Code instance. |
| Cmd6Ctrl6 | Source Control | A Git pane for staging, diffing, and committing. |
| Cmd7Ctrl7 | Browser | A Chromium browser pane with DevTools. |
| Cmd8Ctrl8 | Note | A markdown note with editing and dictation. |
| Cmd9Ctrl9 | Title | A section heading for visually grouping panes. |
| Cmd0Ctrl0 | Insert Media... | A picker that creates an image or video pane. |
Additional enabled harnesses live under Other agents in the spawn menu. The menu always shows the current positional shortcut next to the harness it will open.
Insert Media is an action, not a stored pane type. The selected file becomes either an image pane or a video pane.
Workers are created by masters rather than the spawn menu. A worker pane records its harness, role, selected model, working directory, status, and transcript.
How panes appear
- Press CmdNCtrlN or right-click empty canvas to use the spawn menu.
- Use Cmd1Ctrl1 through Cmd0Ctrl0 for direct positional shortcuts.
- Press CtrlShiftGCtrlShiftG to open Source Control directly.
- Drop an image or video on the canvas to create a media pane.
- Let a master call
spawn_workerorspawn_roleto add a worker.
Dropping a folder sets the space's project folder; it does not create a pane.
Select, move, and rename
- Click a pane or its header to select it.
- Use CmdClickCtrlClick to add or remove panes from a multi-selection.
- Drag a pane's header to move it.
- Press F2F2 to rename the selected pane. This works across agent, worker, terminal, browser, note, code, and other renameable panes.
- Double-click a pane header to rename it in place.
- Press EscEsc to clear selection.
The context menu displays the current rename shortcut if you rebind it.
Agent masters receive an automatic title from the first substantive prompt and response. A manual rename takes precedence, so AgentGrid will not overwrite the name you chose.
Duplicate and fork
Right-click a single pane and choose Duplicate when the action is available.
- Terminal, browser, note, title, code, image, and video panes create an independent copy with the relevant visible state. A duplicated terminal starts a fresh shell rather than replaying the old process.
- Harness masters with session-fork support create a new pane branched from the source conversation. The original session remains unchanged.
- Source-control panes cannot be duplicated because a space owns at most one.
Copies appear offset from the source and AgentGrid searches for nearby free space instead of stacking panes directly on top of one another.
Delete and restore
Delete selected panes with DeleteDelete or CmdBackspaceCtrlBackspace. Undo with CmdZCtrlZ and redo with CmdShiftZCtrlShiftZ.
Restoring a resumable agent pane keeps its session. Restoring a master brings back its worker group in the same undo step.
AgentGrid also attempts to recover agent panes after a CLI crash, out-of-memory exit, renderer crash, or app restart. Resumable sessions reconnect to their recorded session id; if automatic recovery is not possible, the pane keeps the failure visible so you can retry or restore the session deliberately.
Next
- Agents and workers - what runs inside agent and worker panes.
- The Canvas - navigate and organize your panes.
- Spawn menu - the current menu and shortcut rules.