Skip to Content
EnglishKeybindings

Keybindings

ccmux has context-aware keybindings. The status bar at the bottom always shows the available shortcuts for the current mode.

Global

These work in any mode:

KeyAction
Ctrl+QQuit ccmux (kills all shells)
Ctrl+RightCycle focus to next area
Ctrl+LeftCycle focus to previous area
Alt+RightNext tab
Alt+LeftPrevious tab
Alt+1 — Alt+9Jump directly to tab N

Focus cycles through: File Tree → Preview → Pane 1 → Pane 2 → … → File Tree

Tip: Ctrl moves between areas/panes, Alt moves between tabs.

Pane Mode

When a terminal pane is focused:

KeyAction
Ctrl+DSplit vertically (left/right)
Ctrl+ESplit horizontally (top/bottom)
Ctrl+WClose pane (or close tab if single pane)
Alt+T / Ctrl+TNew tab
Alt+RRename tab (session only)
Alt+SToggle status bar
Ctrl+FFocus file tree
Ctrl+PSwap preview/terminal layout
TabForwarded to shell (tab completion)
All other keysForwarded to shell

Tab is always forwarded to the shell for tab completion. Pane switching is done with Ctrl+Right/Left or mouse click.

File Tree Mode

When the file tree is focused (after Ctrl+F):

KeyAction
j / DownMove selection down
k / UpMove selection up
EnterOpen file preview / expand directory
.Toggle hidden files
EscReturn to pane (keep preview open)
Ctrl+FHide file tree and return to pane

Preview Mode

When the preview panel is focused (via Ctrl+Right/Left or click):

KeyAction
j / DownScroll down
k / UpScroll up
h / LeftScroll left
l / RightScroll right
HomeReset horizontal scroll
PageDownScroll down 20 lines
PageUpScroll up 20 lines
Ctrl+WClose preview
Ctrl+PSwap layout
EscReturn to pane

Key Conflicts

Some keys are reserved by ccmux and won’t be forwarded to the shell:

Keyccmux actionShell workaround
Ctrl+DVertical splitUse exit to logout
Ctrl+EHorizontal splitUse End key for end-of-line
Ctrl+FFile treeUse / for search in less/vim
Ctrl+WClose (multi-pane only)Works in single pane mode
Last updated on
FeaturesArchitecture