Cmux

Skill nikships/skills-registry/.agents/skills/cmux

Your personal GitHub registry for AI Agent Skills. One repo. EVERY agent. EVERY device. Loaded on demand — Zero startup bloat.

Install

npx -y skills add nikships/skills-registry --skill cmux

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.

SKILL.md

2.9 KB, as published. Nobody here has run it

cmux Core Control

Use this skill to control non-browser cmux topology and routing.

Core Concepts

Window: top-level macOS cmux window.
Workspace: tab-like group within a window.
Pane: split container in a workspace.
Surface: a tab within a pane (terminal or browser panel).

Fast Start

# identify current caller context
cmux identify --json

# list topology
cmux list-windows
cmux list-workspaces
cmux list-panes
cmux list-pane-surfaces --pane pane:1

# create/focus/move
cmux new-workspace
cmux new-split right --panel pane:1
cmux move-surface --surface surface:7 --pane pane:2 --focus true
cmux split-off --surface surface:7 right
cmux reorder-surface --surface surface:7 --before surface:3

# attention cue
cmux trigger-flash --surface surface:7

Settings and Docs

Use cmux docs settings before changing cmux-owned settings. It prints the docs URL, schema URL, raw GitHub resources, cmux.json paths, and reload command.

cmux docs settings
cmux settings path

cmux-owned settings live in ~/.config/cmux/cmux.json. Legacy ~/.config/cmux/settings.json and ~/Library/Application Support/com.cmuxterm.app/settings.json files are read only as fallback for missing keys. Before editing, copy any existing cmux.json file to a timestamped .bak next to it so the user can revert. Edit the user file, then reload:

cmux reload-config

Use cmux settings for app behavior, sidebar, notifications, browser behavior, automation, workspace colors, and cmux-owned shortcuts. Terminal rendering settings such as font, cursor style, theme, and scrollback belong in Ghostty config.

Open the UI when useful:

cmux settings
cmux settings cmux-json
cmux settings shortcuts

Handle Model

Default output uses short refs: window:N, workspace:N, pane:N, surface:N.
UUIDs are still accepted as inputs.
Request UUID output only when needed: --id-format uuids|both.

Deep-Dive References

Reference	When to Use
references/handles-and-identify.md	Handle syntax, self-identify, caller targeting
references/windows-workspaces.md	Window/workspace lifecycle and reorder/move
references/panes-surfaces.md	Splits, surfaces, move/reorder, focus routing
references/trigger-flash-and-health.md	Flash cue and surface health checks
../cmux-browser/SKILL.md	Browser automation on surface-backed webviews
../cmux-markdown/SKILL.md	Markdown viewer panel with live file watching