Keybindings
All keyboard shortcuts for AgentMux. On macOS, Cmd is used; on Windows/Linux, Alt is used instead.
Command Palette
Section titled “Command Palette”Press Ctrl + P from anywhere to open the command palette — a searchable launcher for the registered command groups listed below. The palette is not exhaustive: most navigation and split shortcuts (Connect Remote, Settings, Focus Block N, Tab Switching, Block Navigation, etc.) are reachable only via their keybindings, not from the palette.
| Key | Action |
|---|---|
Ctrl + P | Open the palette |
| Typed characters | Filter the command list |
↑ / ↓ | Move highlight |
Enter | Run the highlighted command |
Esc | Close the palette |
Commands are grouped by category:
| Category | Commands |
|---|---|
| Open | Open Terminal, Open Agent, Open System Info, Open Swarm, Open Help |
| Split | Split Right / Left / Down / Up |
| Window | New Window, Close Window, Minimize Window, Toggle Maximize |
| Tab | New Tab, Close Tab, Next Tab, Previous Tab |
| Pane | Close Pane, Toggle Magnify, Focus Pane Right / Left / Up / Down |
| Dev | Toggle DevTools, Restart Backend, Open Settings File |
Most commands also have a direct keyboard shortcut — see the tables below.
General
Section titled “General”| Action | macOS | Windows / Linux |
|---|---|---|
| New Tab | Cmd + T | Alt + T |
| New Terminal Block | Cmd + N | Alt + N |
| Open Agent Panel | Cmd + Shift + A | Alt + Shift + A |
| Close Block | Cmd + W | Alt + W |
| Magnify Block | Cmd + M | Alt + M |
| Connect Remote | Cmd + G | Alt + G |
| Settings | Cmd + , | Alt + , |
Tab Switching
Section titled “Tab Switching”| Action | macOS | Windows / Linux |
|---|---|---|
| Switch to Tab N | Cmd + 1-9 | Alt + 1-9 |
| Previous Tab | Cmd + [ | Alt + [ |
| Next Tab | Cmd + ] | Alt + ] |
Block Navigation
Section titled “Block Navigation”| Action | Shortcut |
|---|---|
| Navigate Between Blocks | Ctrl + Shift + Arrow Keys |
| Focus Block N | Ctrl + Shift + 1-9 |
| Focus Agent Panel | Ctrl + Shift + 0 |
Splitting
Section titled “Splitting”| Action | macOS | Windows / Linux |
|---|---|---|
| Split Right | Cmd + D | Alt + D |
| Split Below | Cmd + Shift + D | Alt + Shift + D |
| Split in Direction | Ctrl + Shift + S, then Arrow Key |
Resizing Panes
Section titled “Resizing Panes”Pane resizing is mouse-driven, with Shift selecting the “surgical” variant of each gesture. The modifier is Shift on every platform, and it can be pressed or released mid-drag — the layout re-bases fluidly from wherever it is, with no jumps.
Dragging a pane border
Section titled “Dragging a pane border”| Gesture | Effect |
|---|---|
| Drag a pane border | Resize the whole row/column. The border under the cursor tracks it exactly; every other pane along that axis adjusts proportionally. |
Shift + drag a pane border | Resize a single border. Only the two panes flanking the dragged border change size; everything else stays put. |
Panes have a 128 px minimum size. When a group resize runs out of room on one side, panes stop at the floor and the drag caps at whatever space was actually available.
Dragging a window edge
Section titled “Dragging a window edge”| Gesture | Effect |
|---|---|
| Drag a window edge | Proportional. All panes scale with the window. |
Shift + drag a window edge | Only the edge pane resizes. The pane(s) touching the dragged edge absorb the entire size change; every other pane keeps its exact size. Shrinking floors the edge pane at 128 px, then spills inward pane by pane. |
Shift + window-edge resizing is currently Windows-only; macOS and Linux always resize proportionally.
Customization
Section titled “Customization”Keybindings can be customized in the settings file. See Configuration for details on the settings file location and format.