# Keyboard Shortcuts

Default cmux keyboard shortcuts. Every cmux-owned shortcut can be changed in Settings or ~/.config/cmux/cmux.json, including two-step chords.

Resize the focused pane with Ctrl+Shift+H/J/K/L (left/down/up/right). Hold a key to keep resizing. Change the bindings and Pane Resize Step in Settings → Keyboard Shortcuts. The step is also configurable with app.paneResizeStepPixels in cmux.json (1–200, default 20).

## Shortcut chords

cmux supports two-step shortcut chords in `~/.config/cmux/cmux.json`. For the full configuration schema, see the [configuration docs](https://cmux.com/docs/configuration).

Settings can edit shortcuts directly. Use cmux.json when you want an exact tmux-style prefix binding, keep shortcuts in dotfiles, or unbind an action with null, an empty string, "none", "clear", "unbound", or "disabled".

cmux.json

```
{
  "shortcuts": {
    "bindings": {
      "newSurface": ["ctrl+b", "c"],
      "showNotifications": ["ctrl+b", "i"],
      "toggleSidebar": "cmd+b",
      "toggleFileExplorer": "cmd+opt+b",
      "splitRight": "",
      "commandPalettePrevious": null
    }
  }
}
```

-   Use a plain string for a one-step shortcut.
-   Use a two-item array for a chord. The first item is the prefix stroke, the second is the key that follows it.
-   Each item uses the same syntax as regular bindings, for example cmd+b, ctrl+b, shift+/, or ctrl+1.

[App](https://cmux.com/docs/keyboard-shortcuts#app)·[Workspaces](https://cmux.com/docs/keyboard-shortcuts#workspaces)·[Surfaces](https://cmux.com/docs/keyboard-shortcuts#surfaces)·[Split Panes](https://cmux.com/docs/keyboard-shortcuts#split-panes)·[Canvas](https://cmux.com/docs/keyboard-shortcuts#canvas)·[Browser](https://cmux.com/docs/keyboard-shortcuts#browser)·[Diff Viewer](https://cmux.com/docs/keyboard-shortcuts#diff-viewer)·[Find](https://cmux.com/docs/keyboard-shortcuts#find)·[Notifications](https://cmux.com/docs/keyboard-shortcuts#notifications)

App

Application, window, and top-level command shortcuts.

Settings

⌘+,

Open team picker

⌥+⇧+⌘+T

Reload configuration

⌘+⇧+,

Show/hide all cmux windowssystem-wide hotkey

⌃+⌥+⌘+.

Global searchwhen cmux is active

⌥+⌘+F

Command palette

⌘+⇧+P

Show agent inbox

⌘+⇧+I

Command palette next resultwhen the command palette is open

⌃+N

Command palette previous resultwhen the command palette is open

⌃+P

New window

⌘+⇧+N

Close window

⌃+⌘+W

Toggle full screen

⌃+⌘+F

Send feedbackunbound by default

Reopen previous session

⌘+⇧+O

Quit cmux

⌘+Q

Workspaces

Workspaces live in the sidebar. Each workspace has its own set of panes and surfaces.

Toggle left sidebar

⌘+B

Toggle right sidebar

⌘+⌥+B

New local workspace

⌘+N

New local workspaceopens a local workspace while a remote tmux mirror workspace is active, where New Workspace would start a session on that workspace's host instead

⌃+⌥+⌘+N

New browser workspacelike New Workspace, but the first surface is a browser pane with the address bar focused

⌥+⌘+N

New cloud workspaceuses the most recently selected Cloud workspace's machine, then the first machine in the right-hand sidebar; if no usable machine exists, it opens New Cloud Machine

⌘+Y

New cloud machine

⇧+⌘+Y

Save current workspace layout as a template

⌃+⌘+S

Open folder

⌘+O

Go to workspaceworkspace switcher

⌘+P

Next workspace

⌃+⌘+\]

Previous workspace

⌃+⌘+\[

Next workspace in groupunbound by default; skips the group anchor and uses window-wide cycling when ungrouped

Previous workspace in groupunbound by default; skips the group anchor and uses window-wide cycling when ungrouped

Move workspace up

⌃+⌥+⌘+\[

Move workspace down

⌃+⌥+⌘+\]

Focus backFocus Back/Forward use Cmd+\[ and Cmd+\] outside browser panes; browser Back/Forward use the same defaults inside browser panes. Unbind Focus Back/Forward to let terminal shortcuts handle those keys.

⌘+\[

Focus forwardFocus Back/Forward use Cmd+\[ and Cmd+\] outside browser panes; browser Back/Forward use the same defaults inside browser panes. Unbind Focus Back/Forward to let terminal shortcuts handle those keys.

⌘+\]

Focus lastunbound by default; toggles between the current position and the one focus last left, so pressing it twice returns where you started

Select workspace 1…9

⌘+1…9

Rename workspace

⌘+⇧+R

Edit workspace description

⌥+⌘+E

Mark workspace as done

⌘+;

Cycle workspace status one lane forward

⌘+⇧+;

Toggle the highlighted checklist itemApplies in the focused todo pane or checklist popover.

⌘+↩

New empty workspace group

⌃+⌘+G

Group selected workspaces

⌘+⇧+G

Collapse or expand focused workspace group

⌃+⌘+.

Focus the workspace sidebar↑/↓ select workspaces; Return or Esc returns to the terminal

⌃+⌘+E

Click by hint: label the window's controlsType a label to click it, Shift+label to right-click; Esc cancels. Preview feature, off by default: turn on Click by Hint in Settings > Beta Features or from the command palette

⌘+J

Toggle right-sidebar focus

⌘+⇧+E

Navigate focused sidebar rowsIn Files, H/L collapse and expand folders. Search starts with /.

J / K/⌃+N / P/H / L

Open selected file or toggle folderfocused file explorer

↩

Open selected file or toggle folderFinder-style alias for the focused file explorer

⌘+↓

Close workspace

⌘+⇧+W

Reopen closed workspaceunbound by default

Surfaces

Surfaces are tabs inside a pane.

New surface

⌘+T

Next surface

⌘+⇧+\]

Previous surface

⌘+⇧+\[

Reorder surface left

⌥+⌘+⇧+\[

Reorder surface right

⌥+⌘+⇧+\]

Move surface to previous pane

⌃+⌘+⇧+\[

Move surface to next pane

⌃+⌘+⇧+\]

Move surface to pane on left

⌥+⌘+⇧+←

Move surface to pane on right

⌥+⌘+⇧+→

Move surface to pane above

⌥+⌘+⇧+↑

Move surface to pane below

⌥+⌘+⇧+↓

Select surface 1…9

⌃+1…9

Rename tab

⌘+R

Close tab

⌘+W

Close other tabs in pane

⌥+⌘+T

Reopen last closed

⌘+⇧+T

Toggle terminal copy mode

⌘+⇧+M

Clear screen (keep scrollback)

⌘+⇧+K

Simulator: Homefocused Simulator

⌘+⇧+H

Simulator: rotate leftfocused Simulator

⌘+←

Simulator: rotate rightfocused Simulator

⌘+→

Simulator: toggle appearancefocused Simulator

⌘+⇧+A

Simulator: toggle software keyboardfocused Simulator

⌘+K

Switch focus between terminal and TextBox input

⌘+⇧+A

Cycle TextBox submit action

⇧+Tab

Attach file to TextBox input

⌥+⌘+⇧+A

Send Ctrl-F to terminalunbound by default; forwards Ctrl-F to the focused terminal (Claude Code: invoke twice to force-stop hung background agents)

Size shared terminal to my windowwhen a terminal is shared with phones or other clients, makes this Mac's window set its grid

⌃+⌥+⌘+\=

Paste last screenshotunbound by default; inserts the path of the newest screenshot in the macOS screenshot folder (Desktop unless changed) into the focused terminal, uploading it first in remote workspaces

Save file previewfocused text preview

⌘+S

Toggle File Editor Word Wrapfocused file editor

⌥+Z

Split Panes

Focus pane left

⌥+⌘+←

Focus pane right

⌥+⌘+→

Focus pane up

⌥+⌘+↑

Focus pane down

⌥+⌘+↓

Focus previous pane (cycle)unbound by default; a Ghostty goto\_split:previous keybind also cycles panes while Focus Back does not claim the same keys

Focus next pane (cycle)unbound by default; a Ghostty goto\_split:next keybind also cycles panes while Focus Forward does not claim the same keys

Focus pane 1…9

⌃+⌘+1…9

Split right

⌘+D

Split down

⌘+⇧+D

New pane (auto layout)retiles all panes like Zellij and cmux-tui Alt-n: the right column fills to four panes before a new column opens

⌃+⌘+N

Split browser right

⌥+⌘+D

Split browser down

⌥+⌘+⇧+D

Toggle pane zoom

⌘+⇧+↩

Increase font size for every terminal in the selected workspace

⌃+⌘+\=

Decrease font size for every terminal in the selected workspace

⌃+⌘+\-

Reset font size for every terminal in the selected workspace

⌃+⌘+0

Equalize split sizes

⌃+⌘+⇧+\=

Resize pane left

⌃+⇧+H

Resize pane right

⌃+⇧+L

Resize pane up

⌃+⇧+K

Resize pane down

⌃+⇧+J

Canvas

A freeform 2D layout mode where panes float on an infinite, pannable canvas. Alignment and distribution commands are available from the command palette.

Toggle canvas layout

⌃+⌘+C

Reveal focused pane

⌃+⌘+R

Toggle overview zoom

⌃+⌘+O

Zoom in

⌥+⌘+\=

Zoom out

⌥+⌘+\-

Actual size

⌘+0

Tidy panes into a grid

⌃+⌘+T

Browser

Open browser

⌘+⇧+L

Focus address bar

⌘+L

Back

⌘+\[

Forward

⌘+\]

Reload pagefocused browser

⌘+R

Hard refresh pagefocused browser

⌘+⇧+R

Zoom in

⌘+\=

Zoom out

⌘+\-

Actual size

⌘+0

Markdown viewer: zoom infocused markdown viewer

⌘+\=

Markdown viewer: zoom outfocused markdown viewer

⌘+\-

Markdown viewer: actual sizefocused markdown viewer

⌘+0

Toggle browser developer tools

⌥+⌘+I

Show browser JavaScript console

⌥+⌘+C

Enter browser focus modeGives the focused web page first claim on shortcuts. Press Esc twice to exit.

⌥+⌘+↩

Toggle browser design modeSelect and visually edit elements in the focused browser

⌃+⌥+⌘+D

Toggle React Grabfocused browser, or the only browser pane when a terminal is focused

⌘+⇧+G

Diff Viewer

Open diff viewer

⌃+⌘+⇧+D

Scroll viewer down one smooth stepfocused diff or Markdown viewer

J

Scroll viewer up one smooth stepfocused diff or Markdown viewer

K

Scroll viewer down half a pagefocused diff or Markdown viewer

⌃+D

Scroll viewer up half a pagefocused diff or Markdown viewer

⌃+U

Scroll viewer down one smooth step (Emacs)focused diff or Markdown viewer

⌃+N

Scroll viewer up one smooth step (Emacs)focused diff or Markdown viewer

⌃+P

Scroll diff to bottomfocused diff viewer

⇧+G

Scroll diff to topfocused diff viewer

G+G

Open diff file searchfocused diff viewer

/

Jump to next diff filefocused diff viewer

\]+F

Jump to previous diff filefocused diff viewer

\[+F

Jump to next hunkfocused diff viewer

N

Jump to previous hunkfocused diff viewer

P

Toggle viewed on the current filefocused diff viewer

V

Find

Find

⌘+F

Find in directory

⌘+⇧+F

Find next

⌘+G

Find previous

⌥+⌘+G

Hide find bar

⌥+⌘+⇧+F

Use selection for find

⌘+E

Notifications

Show notifications

⌘+I

Jump to latest unread

⌘+⇧+U

Jump to the surface where you last sent an agent prompt

⌘+⇧+B

Toggle current item unread state

⌥+⌘+U

Mark current item as oldest unread and jump to the next latest unread

⌃+⌘+U

Mark all notifications readunbound by default

Clear all notificationsunbound by default

Flash focused panel

⌘+⇧+H

Canonical: https://cmux.com/docs/keyboard-shortcuts

Documentation index: https://cmux.com/llms.txt