Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-customization — Claude Code skill: what it does, how to install

Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux-customization -a claude-code
Open on GitHub

What cmux-customization does

The skill directs an AI coding agent through editing cmux layouts and viewer preferences. Before touching any file, it inspects existing setups across global paths like ~/.config/cmux/cmux.json and project-level .cmux/cmux.json, making a timestamped backup copy first. App settings and shortcuts run through the schema-aware cmux-settings helper, while terminal-level rendering options such as fonts or color schemes are routed straight to Ghostty configuration instead of invented cmux settings.

Custom actions, tab bar buttons, right-click menus, and workspace split layouts are written directly into JSONC. Project-local entries override global IDs with the same name, which keeps repository-specific dev server or watcher docks isolated. Once changes are written, the agent runs schema validation and triggers cmux reload-config to apply them immediately. Hardcoding API tokens or secrets in command definitions is strictly avoided in favor of environment variables.

What it helps with

  • add custom actions and agent launchers to the Command Palette
  • configure workspace split layouts and dock terminals in .cmux/dock.json
  • route terminal links and markdown files to internal cmux viewers
  • migrate fonts and terminal color palettes from iTerm2, Alacritty, or Kitty
  • validate JSONC syntax and reload cmux configuration safely

Example prompts for the agent

  • Add a new action in cmux Command Palette to run git status in a split pane
  • Configure the cmux plus button to open a project dev workspace by default
  • Route terminal URLs to the built-in cmux browser in ~/.config/cmux/cmux.json

How to install cmux-customization

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-customization -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-customization/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-customization/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

learn tw93 A six-phase research workflow that turns source material into notes, an outline, or a publish-ready draft. Use it for unfamiliar domains and multi-source work. Claude Code CX Codex Cursor +1 13,100installs cli-hub-meta-skill HKUDS A skill that gives agents a catalog of professional command-line tools built for AI. Search, install, and run CLIs for video, design, AI, and development without leaving your editor. Claude Code CX Codex Cursor +1 5,300installs codex-result-handling official openai A skill that ensures Codex results are presented to you properly. Preserves findings, inferences, file paths, line numbers, and severity order. Blocks automatic code fixes after review—you must approve changes first. Claude Code CX Codex Cursor +1 675installs surprise-me bytedance This skill combines available skills into one unexpected creative deliverable. Use it when you want inspiration or a project without choosing the format yourself. Claude Code CX Codex Cursor +1 2,300installs cloud-sync thedotmack Syncs your claude-mem database with cmem.ai Pro cloud storage. Checks sync status, manages the connection, and uploads observation narratives to the server. Claude Code CX Codex Cursor +1 2,100installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs

Questions about cmux-customization

How to install cmux-customization in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-customization -a claude-code in your terminal.

What does the cmux-customization skill do?

It instructs your assistant how to safely edit cmux.json and .cmux/dock.json, manage backups, and validate changes with cmux reload-config.

When does the skill modify Ghostty instead of cmux.json?

Terminal fonts, cursor styles, color themes, and terminal keybindings belong in Ghostty config; the skill routes those edits to Ghostty rather than creating unsupported cmux keys.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor