Keyboard shortcuts
Current AgentGrid keyboard shortcuts, grouped by focus context.
Shortcuts are context-sensitive: canvas actions stand down while you type in a terminal, editor, or text field. The chips below show platform-correct keys; use the switcher to preview another platform.
Spaces and global actions
| Shortcut | Action |
|---|---|
| CmdTCtrlT | New space |
| CmdWCtrlW | Close the active space |
| CmdShiftTCtrlShiftT | Reopen the last closed space |
| CmdOption←CtrlShiftTab | Previous space |
| CmdOption→CtrlTab | Next space |
| CmdZCtrlZ | Undo a pane or space close |
| CmdShiftZCtrlShiftZ | Redo a close |
| Cmd\Ctrl\ | Toggle the workspace explorer |
| CmdShift\CtrlShift\ | Toggle the Coordinator pane — its draft, queued follow-ups, scroll position and any running turn survive a hide, and the previous width comes back on reveal |
| CmdFCtrlF | Focus explorer search, or search inside the focused pane |
| CmdShift2CtrlShift2 | Zoom and center on the selected pane, or fit the workspace |
| Ctrl-Alt← | Go back through canvas view history |
| CtrlShift-Alt→ | Go forward through canvas view history |
| Cmd]Ctrl] | Select and reveal the next pane in workspace-explorer order |
| Cmd[Ctrl[ | Select and reveal the previous pane in workspace-explorer order |
| CmdShift]CtrlShift] | Jump to the next sibling group — the first pane of the group beside the current pane's parent |
| CmdShift[CtrlShift[ | Jump to the previous sibling group |
Undo and redo defer to the active editor while focus is inside editable content.
Both panel toggles fire from anywhere — an agent composer, the Coordinator, a terminal, a note or a browser page. The one exception is the unshifted Ctrl\Ctrl\ inside a Windows / Linux terminal, which stays the shell's quit signal; the shifted Coordinator chord is not a control byte, so it works in terminals on every platform. When the Coordinator hides while its composer has focus, focus returns to the pane you were in before, so Enter never submits into a hidden composer.
Next / previous pane follow the explorer's displayed order in the current space — groups, nesting, sort mode and the search filter included — and stop at the first and last pane rather than wrapping. With nothing focused or selected, next starts at the first pane and previous at the last. A folded parent unfolds to reveal the destination. Both chords fire while typing in an agent composer or a macOS terminal; a note editor and a browser page keep them, and on Windows / Linux a focused terminal keeps Ctrl[Ctrl[ (Escape) and Ctrl]Ctrl].
The shifted chords hop a level up: from any member of a group — or any worker of a master — they skip the rest of that group and land on the first pane of the next / previous group beside its parent, never on the group row itself. At the top level, groups, masters and loose panes are each other's neighbours, so this is how you move team to team. The same starting-point, no-wrap and unfold rules apply, and with nothing selected CmdShift]CtrlShift] enters the first top-level group and CmdShift[CtrlShift[ the last. Because a shifted chord is never a terminal control byte, these also fire from a focused terminal on Windows / Linux.
Canvas
| Shortcut or gesture | Action |
|---|---|
| Hold OptionCtrl + drag, middle-click, or scroll | Pan from anywhere, including over live panes |
| CmdScrollCtrlScroll | Zoom under the cursor |
| Trackpad pinch | Zoom the canvas |
| Cmd=Ctrl= / Cmd-Ctrl- | Zoom in / out |
| CmdNCtrlN | Open the spawn menu at the cursor |
| Cmd1Ctrl1 through Cmd3Ctrl3 | Spawn the first, second, or third enabled harness |
| Cmd4Ctrl4 | Spawn a terminal |
| Cmd7Ctrl7 | Spawn a browser |
| Cmd8Ctrl8 | Spawn a note |
| Cmd9Ctrl9 | Spawn a title |
| Cmd0Ctrl0 | Insert image or video panes |
| CmdVCtrlV | Paste clipboard images or videos as panes when canvas has focus |
| F2F2 | Rename the selected pane, including browser, note, and worker panes |
| DeleteDelete / CmdBackspaceCtrlBackspace | Delete selected panes |
| EscEsc | Clear selection and close menus |
CmdRCtrlR remains the alternate rename binding for non-browser panes. On a browser pane it reloads the page; F2F2 always uses the pane rename action.
Space is ordinary terminal and editor input. Canvas pan moved to Option on macOS and Ctrl on Windows/Linux.
Terminal-backed panes
These behaviors apply to plain terminals and supported harness panes unless noted.
| Shortcut | Action | Notes |
|---|---|---|
| CmdFCtrlF | Search scrollback | Enter finds next, Shift+Enter finds previous, Esc closes. |
| ShiftEnterShiftEnter | Insert a newline | Provider-specific translation; Claude receives its CLI newline sequence. |
| Cmd←Home / Cmd→End | Start / end of line | macOS translates the chord for shells and TUIs. |
| Cmd↑PgUp / Cmd↓PgDn | Previous / next history page | macOS translates the chord for shells and TUIs. |
| CmdVCtrlV | Paste | Text is bracketed and sanitized. Clipboard images attach directly when the harness supports image input; otherwise AgentGrid pastes a saved file path. |
| CmdKCtrlK | Clear visible scrollback | Clears the rendered viewport without sending a shell command or restarting the process. |
Standard terminal chords such as CtrlCCtrlC, CtrlDCtrlD, CtrlLCtrlL, and CtrlRCtrlR pass through to the PTY.
Browser panes
| Shortcut | Action |
|---|---|
| CmdRCtrlR | Reload the page |
| CmdFCtrlF | Search within the browser pane |
| Hold CtrlAlt while pinching | Send zoom to the page instead of the canvas |
| F2F2 | Rename the browser pane |
Workspace explorer
| Shortcut | Action |
|---|---|
| CmdFCtrlF | Focus the search field |
| EnterEnter | Open or focus the highlighted pane |
| SpaceSpace | Expand or collapse the highlighted group |
| F2F2 | Rename the selected pane |
| EscEsc | Clear the search query |
Right-click the explorer for Collapse all and Expand all.
Voice
Open a call from a supported pane's Phone button. CmdMCtrlM toggles mute while the call overlay is open, and EscEsc dismisses the overlay.
Push-to-talk is unbound by default on every platform — record a key in Settings -> Shortcuts to opt in. It is an in-app shortcut, not a system-wide hotkey. (A bare AltAlt default would collide with the AltAlt+Arrow pane focus history chords.)
Source control
Open Source Control from an agent pane to review its worktrees, diffs, commits, and pull requests.