AgentGridAgentGrid Docs
Reference

Keyboard shortcuts

Current AgentGrid keyboard shortcuts, grouped by focus context.

Shortcuts are context-sensitive: canvas actions generally stand down while you type in a terminal, editor, or text field. On Mac, the close-pane shortcut also works while typing and inside browser pages. The chips below show platform-correct keys; use the switcher to preview another platform.

Most shortcuts can be rebound under Settings -> Shortcuts, which always shows your current bindings.

Windows, spaces and global actions

ShortcutAction
CmdShiftNCtrlShiftNNew window
CmdShiftWCtrlShiftWClose the window
CmdOCtrlOOpen a project folder; loaded work stays in its tab, and an already-open folder focuses its owner
CmdTCtrlTNew space
CmdWCtrlWClose the active space
CmdShiftTCtrlShiftTReopen the last closed space
CmdOption←CtrlShiftTabPrevious space
CmdOption→CtrlTabNext space
CmdPCtrlPOpen the Omnibox
CmdKCtrlKOpen the Omnibox (except in a focused terminal or browser page)
Cmd,Ctrl,Open or close Settings, including from a focused terminal or browser page
CmdZCtrlZUndo a close, move, arrange or grouping change
CmdShiftZCtrlShiftZRedo
Cmd\CtrlBShow or hide the left panel
CmdShift\CtrlShift\Show or hide the right panel
CmdLCtrlLShow or hide the Coordinator, wherever it is docked. Showing it puts the cursor in its input
CmdShiftLCtrlShiftLPut the cursor at the end of the Coordinator input without closing it, opening the Coordinator first if it is hidden
CmdFCtrlFFocus explorer search, or search inside the focused pane. In a conversation, folded blocks stay folded and show an "N matches" badge; only the block with the focused result opens
RRQuote the text selected in a transcript into that conversation's composer
CmdOptionRAltShiftRRead aloud the selected transcript text, the reply under the pointer from that paragraph on, or the focused chat's latest reply; in a focused browser page, the page's selection or its main text, so the page no longer receives this key. Press again to stop (Pro)
CmdShiftEnterCtrlShiftEnter or CtrlShift2CtrlShift2Maximize the focused or selected pane, or the Coordinator when you're in it; press again or Escape to restore your exact view and transcript reading position. From inside the pane, Escape first leaves it (twice quickly in a terminal or agent prompt)
Ctrl-Alt←Go back to the pane you focused before
CtrlShift-Alt→Go forward through the panes you focused
Cmd]Ctrl]Select and reveal the next pane in workspace-explorer order
Cmd[Ctrl[Select and reveal the previous pane in workspace-explorer order
CmdShiftUCtrlShiftUSelect and reveal the next team marked Needs you
CmdShift]CtrlShift]Jump to the first pane of the next group or ungrouped team
CmdShift[CtrlShift[Jump to the first pane of the previous group or ungrouped team

The Omnibox searches panes in every space by name, alias, pull request or harness, and lists matching commands with their shortcuts. ShiftEnterShiftEnter selects a pane without zooming. Type >> first to list only commands. Inside a focused terminal, CmdKCtrlK keeps clearing the terminal, so use CmdPCtrlP there.

Undo and redo defer to the active editor while focus is inside editable content. In an agent composer, CmdZCtrlZ also brings back an attachment you just removed.

The explorer and the Coordinator sit on opposite edges. The left and right panel shortcuts follow the edge, so they keep working if you turn on Coordinator in left pane under Settings -> Agents. Hiding the Coordinator keeps its draft, queued follow-ups, scroll position and any running turn, and showing it again restores its width. On Windows and Linux a focused terminal keeps CtrlLCtrlL for clearing the screen, so use CtrlShiftLCtrlShiftL there: it moves the cursor into the Coordinator input and keeps your draft. If another app on your computer already uses CmdShiftLCtrlShiftL, rebind it under Settings -> Shortcuts. CmdShift\CtrlShift\ also works, but only while the Coordinator is docked on the right.

Back and forward step through the panes you focused, across spaces, and restore each pane's last zoom. While a pane is maximized they switch the maximized pane instead and leave the canvas view alone; restoring then centers the pane you ended on.

Next and previous pane follow the explorer's displayed order in the current space, including groups, nesting, sort mode and the search filter. They stop at the first and last pane rather than wrapping. With nothing selected, next starts at the first pane and previous at the last. A folded parent unfolds to reveal the destination. A note editor and a browser page keep these chords; on Windows / Linux a focused terminal keeps Ctrl[Ctrl[ (Escape) and Ctrl]Ctrl].

The shifted chords skip the rest of the current group and land on the first pane of the next or previous group, stepping over loose panes. They wrap from the last group back to the first. With nothing selected, CmdShift]CtrlShift] enters the first group and CmdShift[CtrlShift[ the last.

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 what you're working in: the focused Coordinator or Explorer, else a maximized pane's content (including a browser page), else the canvas. Each pane keeps its own level, from 50% to 200%; zoom-in stops early when the content would get too narrow (CmdCtrl with the numeric keypad's plus and minus works too)
Cmd0Ctrl0Reset the same target to 100%; the canvas keeps the view centred
Arrow keysNudge the selected panes, or pan the canvas when nothing is selected. Hold ShiftShift for a bigger step.
CmdNCtrlNOpen the spawn menu at the cursor. While a pane is maximized, open a new agent right away with the project's Default agent, if it has one, or else the harness you last opened an agent with (or the first harness in Settings → Agents), keeping the view maximized on it
Cmd1Ctrl1 through Cmd3Ctrl3Spawn the first, second, or third enabled harness in the spawn menu. A project's Default agent comes first, so it takes Cmd1Ctrl1, and agents the project blocks are left out
Cmd4Ctrl4Spawn a terminal
Cmd7Ctrl7Spawn a browser
Cmd8Ctrl8Spawn a note
Cmd9Ctrl9Spawn a title
CmdShiftMCtrlShiftMInsert image or video panes
CmdVCtrlVPaste clipboard images or videos as panes when canvas has focus
F2F2Rename the selected pane, including browser, note, and worker panes
CmdShiftBackspaceDeleteClose the focused or selected pane on Mac, including while typing or inside browser panes; on Windows and Linux, close selected panes from the canvas (archived, with Undo). The same Close is in the pane menu and on workspace explorer rows
CmdGCtrlGGroup the selected panes (two or more)
CmdShiftGCtrlShiftGRemove the selected panes from their groups
CmdShiftRCtrlShiftRReorganize the selected panes into a tidy team layout
CmdDCtrlShiftDFork the selected (or focused) agent pane into a new session, like its Fork menu item. Works while typing in a terminal, composer, editor or browser page; CtrlDCtrlD still reaches the shell on Windows and Linux
CmdShiftECtrlShiftEReveal the selected (or focused) pane in the workspace explorer. Works while typing in a terminal, composer, editor or browser page
EscEscClear selection and close menus

A narrowed Coordinator or Explorer temporarily lowers its displayed zoom to fit, down to 100%, while keeping your saved level for when there is room again. Zoom-out steps from the displayed level; a zoom-in that cannot fit leaves the saved level unchanged.

The zoom shortcuts also accept CmdShift=CtrlShift= (plus), CmdShift-CtrlShift- (underscore), and Cmd/Ctrl with numpad +, − or 0, including 0 with NumLock off. Browser pages forward these too. Rebinding or disabling a zoom shortcut replaces all its default aliases; a saved app shortcut on the same chord takes priority.

Backspace alone never closes panes. On Mac, fn+Backspace no longer closes panes by default; use Cmd+Shift+Backspace instead. Cmd+Shift+Backspace no longer closes a pane you can't see.

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.
Cmd←Home / Cmd→EndStart / end of linemacOS translates the chord for shells and TUIs.
Cmd↑PgUp / Cmd↓PgDnPrevious / 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
ShiftEscShiftEscMark the selected rows as read, including every worker or member beneath them
EscEscClear the search query

CmdClickCtrlClick adds or removes rows from the selection. Right-click the explorer for Collapse all and Expand all.

Voice

Open a call from a supported pane's Phone button. When the call overlay has focus, or nothing in the window does, CmdMCtrlM toggles mute during a call and EscEsc ends the call.

Hold Cmd;Ctrl; to dictate and release to insert without sending. For the microphone, Stop and Stop and send controls, see Voice mode. Rebind or clear it in Settings -> Shortcuts. It is an in-app shortcut, not a system-wide hotkey.

Source control

Open Source Control from an agent pane to review its worktrees, diffs, commits, and pull requests.

On this page

Ask AI

Ask a question about AgentGrid. Answers come from these docs, with links to the pages they use.

AI answers can be wrong. Check the linked pages.