Field notes

cmux

Workspaces, split panes, surfaces, browser splits and CLI automation, built on Ghostty with native macOS shortcuts.

Everyday

Workspaces8

New workspace
Close workspace
Rename workspace
Toggle sidebar
Next workspace
Previous workspace
Jump to workspace 1–8
Jump to last workspace

Surfaces (tabs)9

New terminal surface
Close surface
Rename surface
Next surface
Previous surface
Next surface (alt)
Previous surface (alt)
Jump to surface 1–8
Jump to last surface

Split panes6

Split right (vertical)
Split down (horizontal)
Split browser right
Split browser down
Toggle pane zoom (fullscreen)
Flash focused pane

Pane navigation4

Focus pane left
Focus pane right
Focus pane up
Focus pane down

Terminal7

Clear scrollback
Copy selection
Paste clipboard
Increase font size
Decrease font size
Reset font size
Toggle copy mode (vim)

Copy mode6

Enter copy mode
Start / adjust selection
Copy selection and exit
Copy selection and exit
Exit without copying
Exit without copying

Copy mode navigation10

Move cursor (vim)
Word forward / backward
Line start / end
Beginning of buffer
End of buffer
Half page up / down
Full page up / down
Scroll one line up / down
Scroll one page
Jump to top / bottom

Find5

Open find bar
Find next match
Find previous match
Hide find bar
Use selection for find

Browser splits7

Open browser in split
Focus address bar
Navigate back
Navigate forward
Reload page
Toggle Developer Tools
JavaScript Console

Window and app6

New window
Open settings
Reload Ghostty config
Open folder
Send feedback
Quit cmux

Notifications2

Show notifications panel
Jump to latest unread

Workflows

Workspaces and panes from the CLI12

Create named workspace
List all workspaces
Switch to workspace
Close workspace
Split pane right
Split pane down
New surface in pane
Focus specific pane
Show full window/workspace/pane tree
Current workspace/pane/surface info
Send text to focused surface
Send key to focused surface

Browser automation9

Navigate to URL
Get DOM accessibility snapshot
Click element
Fill form field
Evaluate JavaScript
Capture page screenshot
Wait for element
Get current URL
Get page title

Configure

Environment variables4

Control socket path for CLI
UUID of current surface/tab
UUID of current pane
UUID of current workspace

Reference

Sidebar6

Current git branch per workspace
Linked GitHub PR number and status
Current path for workspace
Listening ports detected automatically
Unread notification indicator
Latest notification preview