Cmux Customization
Customize cmux for an end user, including terminal, browser, Markdown, diff, file...
Install
npx skills add manaflow-ai/cmux --skill cmux-customization -g -a claude-code -y- Repository
- manaflow-ai/cmux28.6k
- Category
- Writing
- Updated
- 3d ago
- License
- See repository
- Context cost
- Mediumabout 1,656 tokens
- Runs scripts
- No, instructions only
What it does
Customize cmux for an end user, including terminal, browser, Markdown, diff, file preview, notes, HTML, and right-sidebar viewers. Use when changing cmux.json actions, custom commands, workspace layouts, plus-button behavior, surface tab bar buttons, Command Palette entries, Dock controls, sidebar and app settings, shortcuts, notifications, browser routing, examples-library presets, or Ghostty-backed terminal preferences.
cmux Customization
Keep the user's config intact, prefer schema-backed edits, and validate before reporting completion.
For content viewers, start with the viewer customization matrix. It maps each viewer to the settings, command, or external file that owns its knobs, including explicit fallbacks for viewer types whose template settings have not shipped yet.
Choose the right surface
| Want to change | Edit |
|---|---|
| App preferences (appearance, sidebar, notifications, browser routing, automation, shortcuts, new-workspace placement) | ~/.config/cmux/cmux.json via the cmux-settings helper |
| Custom actions, workspace layouts/commands, tab bar buttons, plus-button behavior, Command Palette entries, notification hooks | ~/.config/cmux/cmux.json globally or .cmux/cmux.json in the project |
Dock controls (right-sidebar terminals: logs, test watchers, git TUIs, dev servers, queues, cmux feed tui --opentui) | .cmux/dock.json or ~/.config/cmux/dock.json; cmux docs dock when available |
| Terminal rendering and terminal keybindings (fonts, themes, cursor style, copy-on-select, shell integration) | Ghostty config, usually ~/.config/ghostty/config |
| Bring fonts, colors and terminal behavior over from iTerm2, Terminal, Alacritty, Kitty, WezTerm or a Warp theme | cmux import <terminal> --dry-run to preview, then cmux import <terminal>; writes cmux's own Ghostty config and a generated theme, never ~/.config/ghostty/config |
| Workspace names, descriptions, colors, read state, sidebar metadata | cmux CLI, see ../cmux-workspace/SKILL.md |
| Feed event sources | cmux hooks setup |
