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.