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
| Shortcut | Action |
|---|---|
| CmdShiftNCtrlShiftN | New window |
| CmdShiftWCtrlShiftW | Close the window |
| CmdOCtrlO | Open a project folder; loaded work stays in its tab, and an already-open folder focuses its owner |
| CmdTCtrlT | New space |
| CmdWCtrlW | Close the active space |
| CmdShiftTCtrlShiftT | Reopen the last closed space |
| CmdOption←CtrlShiftTab | Previous space |
| CmdOption→CtrlTab | Next space |
| CmdPCtrlP | Open the Omnibox |
| CmdKCtrlK | Open the Omnibox (except in a focused terminal or browser page) |
| Cmd,Ctrl, | Open or close Settings, including from a focused terminal or browser page |
| CmdZCtrlZ | Undo a close, move, arrange or grouping change |
| CmdShiftZCtrlShiftZ | Redo |
| Cmd\CtrlB | Show or hide the left panel |
| CmdShift\CtrlShift\ | Show or hide the right panel |
| CmdLCtrlL | Show or hide the Coordinator, wherever it is docked. Showing it puts the cursor in its input |
| CmdShiftLCtrlShiftL | Put the cursor at the end of the Coordinator input without closing it, opening the Coordinator first if it is hidden |
| CmdFCtrlF | Focus 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 |
| RR | Quote the text selected in a transcript into that conversation's composer |
| CmdOptionRAltShiftR | Read 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 CtrlShift2CtrlShift2 | Maximize 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 |
| CmdShiftUCtrlShiftU | Select 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 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 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) |
| Cmd0Ctrl0 | Reset the same target to 100%; the canvas keeps the view centred |
| Arrow keys | Nudge the selected panes, or pan the canvas when nothing is selected. Hold ShiftShift for a bigger step. |
| CmdNCtrlN | Open 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 Cmd3Ctrl3 | Spawn 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 |
| Cmd4Ctrl4 | Spawn a terminal |
| Cmd7Ctrl7 | Spawn a browser |
| Cmd8Ctrl8 | Spawn a note |
| Cmd9Ctrl9 | Spawn a title |
| CmdShiftMCtrlShiftM | 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 |
| CmdShiftBackspaceDelete | Close 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 |
| CmdGCtrlG | Group the selected panes (two or more) |
| CmdShiftGCtrlShiftG | Remove the selected panes from their groups |
| CmdShiftRCtrlShiftR | Reorganize the selected panes into a tidy team layout |
| CmdDCtrlShiftD | Fork 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 |
| CmdShiftECtrlShiftE | Reveal the selected (or focused) pane in the workspace explorer. Works while typing in a terminal, composer, editor or browser page |
| EscEsc | Clear 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.
| 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 |
| ShiftEscShiftEsc | Mark the selected rows as read, including every worker or member beneath them |
| EscEsc | Clear 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.