cmux-customization

Edit cmux.json actions, UI controls, and workspace layouts with validated minimal diffs.

1|Updated Sep 6, 2015
One-click install
npx skills add https://github.com/deerawan/dotfiles --skill cmux-customization
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux-customization
Source: https://github.com/deerawan/dotfiles/tree/main/agents/skills/cmux-customization
Command: npx skills add https://github.com/deerawan/dotfiles --skill cmux-customization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about cmux-customization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the tab bar buttons and plus-button menu in cmux?▼

Customize cmux tab bar buttons and plus-button menus by editing the `actions` array in `.cmux/cmux.json`. This adds entries to the Command Palette, tab bar buttons, shortcuts, and plus-button menus.

How can I configure multi-pane workspace layouts for terminals and browsers in cmux?▼

You can configure multi-pane workspace layouts in cmux by defining `commands` with workspace definitions in your `cmux.json` file. This lets you open deliberate layouts containing terminals, browsers, and SSH sessions all at once.

What is the safest way to edit cmux configuration without breaking existing settings?▼

The safest way to edit cmux configuration is to inspect existing settings, back up the file, apply minimal-diff edits, and validate the schema before reloading. This preserves unrelated user-owned configuration and prevents breaks.

Where do I configure dock controls for side-bar terminals in cmux?▼

You configure dock controls for side-bar terminals in cmux by editing either the project-local `.cmux/dock.json` file or the global `~/.config/cmux/dock.json` file, depending on whether you want project-specific or system-wide behavior.

How do I apply changes to cmux.json after updating actions and UI controls?▼

After updating actions and UI controls in `cmux.json`, you apply the changes by running the `cmux reload-config` command. This reload steps ensures your new workspace layouts, tab bar buttons, and dock controls take effect.

Can I wire browser routing and notification behavior into cmux workspace layouts?▼

Yes, you can wire browser routing and notification behavior into cmux workspace layouts. By customizing the `actions` and `commands` in `cmux.json`, you configure specific routing and notification workflows for your project.