Guides
Keyboard shortcuts
One prefix chord drives everything in attach. Default is Ctrl-b, changeable with
vmux config set ui.prefix_key Ctrl-a.
Prefix-key map
| Keys | Action |
|---|---|
| Ctrl-b + arrow | Move focus between panes |
| Ctrl-b z | Zoom the active pane |
| Ctrl-b [ / ] | Previous / next tab |
| Ctrl-b t | New tab |
| Ctrl-b w | Workspace picker (j/k or arrows, Enter to switch, Esc to close) |
| Ctrl-b B | Toggle the sidebar |
| Ctrl-b u | Jump to whatever just notified you |
| Ctrl-b P | Command palette |
| Ctrl-b G | Agent status panel |
| Ctrl-b A | Project actions (from vmux.json) |
| Ctrl-b o | Ports panel |
Ports panel
Once the ports panel is open (Ctrl-b o, or the command palette → ports):
| Key | Action |
|---|---|
| j / k | Select a port |
| Enter | Focus the owning pane |
| c | Copy the ssh -L command (OSC 52 + local clipboard tools) |
| f | Tailscale forward |
| x | Unforward |
| r | Rescan |
| Esc | Close |
More on ports: Ports & forwarding.
Mouse
The mouse works too (ui.mouse, default on):
- Wheel to scroll back in a pane's history
- Right-click a pane for copy, paste, split, and clear
Changing the prefix key
vmux config set ui.prefix_key Ctrl-aEvery shortcut above shifts to whatever chord you set — the mapping does not change, only the prefix.