Skip to content

Keybindings

All keyboard shortcuts for AgentMux. On macOS, Cmd is used; on Windows/Linux, Alt is used instead.

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.

KeyAction
Ctrl + POpen the palette
Typed charactersFilter the command list
/ Move highlight
EnterRun the highlighted command
EscClose the palette

Commands are grouped by category:

CategoryCommands
OpenOpen Terminal, Open Agent, Open System Info, Open Swarm, Open Help
SplitSplit Right / Left / Down / Up
WindowNew Window, Close Window, Minimize Window, Toggle Maximize
TabNew Tab, Close Tab, Next Tab, Previous Tab
PaneClose Pane, Toggle Magnify, Focus Pane Right / Left / Up / Down
DevToggle DevTools, Restart Backend, Open Settings File

Most commands also have a direct keyboard shortcut — see the tables below.

ActionmacOSWindows / Linux
New TabCmd + TAlt + T
New Terminal BlockCmd + NAlt + N
Open Agent PanelCmd + Shift + AAlt + Shift + A
Close BlockCmd + WAlt + W
Magnify BlockCmd + MAlt + M
Connect RemoteCmd + GAlt + G
SettingsCmd + ,Alt + ,
ActionmacOSWindows / Linux
Switch to Tab NCmd + 1-9Alt + 1-9
Previous TabCmd + [Alt + [
Next TabCmd + ]Alt + ]
ActionShortcut
Navigate Between BlocksCtrl + Shift + Arrow Keys
Focus Block NCtrl + Shift + 1-9
Focus Agent PanelCtrl + Shift + 0
ActionmacOSWindows / Linux
Split RightCmd + DAlt + D
Split BelowCmd + Shift + DAlt + Shift + D
Split in DirectionCtrl + Shift + S, then Arrow Key

Run these from any terminal pane:

CommandDescription
wsh view [file|url]Preview files, directories, or web URLs in a new pane
wsh edit [file]Open a file for editing in a code preview pane

Keybindings can be customized in the settings file. See Configuration for details on the settings file location and format.