What problem does it solve?
cmux customization can be tedious and risky when you need to update user-facing actions, workspace layouts, tab bar buttons, dock controls, and routing without breaking the rest of the configuration.
Core Features & Use Cases
- User-facing cmux wiring: Define and adjust
actions in cmux.json so they appear in the Command Palette, tab bar buttons, shortcuts, and plus-button menus.
- Workspace layout control: Configure
commands with workspace definitions to open deliberate multi-pane layouts (terminals, browsers, SSH sessions, and more).
- UI and control surface updates: Set
ui.newWorkspace behavior and ui.surfaceTabBar.buttons, and manage side-bar terminal controls via .cmux/dock.json or ~/.config/cmux/dock.json.
- Safe, validated editing workflow: Inspect existing config, back up before changes, apply smallest diffs, validate via helper tools where available, and reload after success.
Quick Start
Use the cmux-customization skill to update your project-local .cmux/cmux.json (and .cmux/dock.json if needed) for the specific behaviors you want, then reload with cmux reload-config.