AgentGridAgentGrid Docs
Reference

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

ShortcutAction
CmdTCtrlTNew space
CmdWCtrlWClose the active space
CmdShiftTCtrlShiftTReopen the last closed space
CmdOptionCtrlShiftTabPrevious space
CmdOptionCtrlTabNext space
CmdZCtrlZUndo a pane or space close
CmdShiftZCtrlShiftZRedo a close
Cmd\Ctrl\Toggle the workspace explorer
CmdFCtrlFFocus explorer search, or search inside the focused pane
CmdShift2CtrlShift2Zoom and center on the selected pane, or fit the workspace
Ctrl-AltGo back through canvas view history
CtrlShift-AltGo forward through canvas view history

Undo and redo defer to the active editor while focus is inside editable content.

Canvas

Shortcut or gestureAction
Hold OptionCtrl + drag, middle-click, or scrollPan from anywhere, including over live panes
CmdScrollCtrlScrollZoom under the cursor
Trackpad pinchZoom the canvas
Cmd=Ctrl= / Cmd-Ctrl-Zoom in / out
CmdNCtrlNOpen the spawn menu at the cursor
Cmd1Ctrl1 through Cmd3Ctrl3Spawn the first, second, or third enabled harness
Cmd4Ctrl4Spawn a terminal
Cmd5Ctrl5Spawn a code editor
Cmd6Ctrl6Spawn source control
Cmd7Ctrl7Spawn a browser
Cmd8Ctrl8Spawn a note
Cmd9Ctrl9Spawn a title
Cmd0Ctrl0Insert image or video panes
CtrlShiftGCtrlShiftGSpawn source control directly
CmdVCtrlVPaste clipboard images or videos as panes when canvas has focus
CmdShiftFCtrlShiftFToggle canvas filters
F2F2Rename the selected pane, including browser, note, code, and worker panes
DeleteDelete / CmdBackspaceCtrlBackspaceDelete selected panes
EscEscClear 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.

ShortcutActionNotes
CmdFCtrlFSearch scrollbackEnter finds next, Shift+Enter finds previous, Esc closes.
ShiftEnterShiftEnterInsert a newlineProvider-specific translation; Claude receives its CLI newline sequence.
CmdHome / CmdEndStart / end of linemacOS translates the chord for shells and TUIs.
CmdPgUp / CmdPgDnPrevious / next history pagemacOS translates the chord for shells and TUIs.
CmdVCtrlVPasteText is bracketed and sanitized. Clipboard images attach directly when the harness supports image input; otherwise AgentGrid pastes a saved file path.
CmdKCtrlKClear visible scrollbackClears 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

ShortcutAction
CmdRCtrlRReload the page
CmdFCtrlFSearch within the browser pane
Hold CtrlAlt while pinchingSend zoom to the page instead of the canvas
F2F2Rename the browser pane

Workspace explorer

ShortcutAction
CmdFCtrlFFocus the search field
EnterEnterOpen or focus the highlighted pane
SpaceSpaceExpand or collapse the highlighted group
F2F2Rename the selected pane
EscEscClear 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

Inside the commit-message editor, CmdEnterCtrlEnter commits staged changes.

On this page