Cmux Keyboard Shortcuts

If you're deep in cmux and tired of fighting the defaults, this builds you a custom shortcut layer without touching the GUI. It ships preset templates for tmux chords, Vim-style pane nav, and macOS Terminal muscle memory, plus one-off rebinds and audits. The workflow snapshots your current bindings before applying a template so you get exact revert commands if you hate it. It knows which actions need modifiers, which ones are system-wide, and that showHideAllWindows requires an extra toggle in settings. Useful if you context-switch between tmux sessions and cmux windows, or if you just want cmd+opt+hjkl to work without a prefix.

skills.sh installs: 6.4K
GitHub stars: 28.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-keyboard-shortcuts --agent claude-code

Installs into .claude/skills of the current project.

Files

cmux-keyboard-shortcuts

Turn a user's workflow preferences into cmux shortcut bindings in ~/.config/cmux/cmux.json: guide, propose compact templates, apply the selected changes, and confirm the config parses with recognized keys.

Contributor rule: adding a new shortcut

Every new cmux-owned keyboard shortcut must be added to Sources/KeyboardShortcutSettings.swift, visible and editable in Settings > Keyboard Shortcuts, supported as shortcuts.bindings.<actionId> in ~/.config/cmux/cmux.json, and documented in web/app/[locale]/(landing)/docs/keyboard-shortcuts/page.tsx and the configuration docs. All four, not a subset.

Prerequisites

Work from a cmux checkout or worktree root when possible.
Use skills/cmux-settings/scripts/cmux-settings for every read/write. It reads JSONC, writes atomically, and validates JSON plus recognized settings keys.
Action IDs: skills/cmux-settings/references/shortcut-actions.md. Current defaults: web/data/cmux-shortcuts.ts or Sources/KeyboardShortcutSettings.swift.

SKILL.md on GitHub