cmux
Control the cmux macOS terminal app: workspaces, panes, surfaces, browsers, notifications, settings, and hooks. Use only when the user explicitly names cmux. Read before running any cmux command.
Install / Use
npx skills add davidondrej/skills --skill cmuxInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
CommunicationSupported Platforms
Tags
Our assessment of cmux
cmux scores 87/100 on our quality scale, 253rd of 394 Communication skills we index.
Its SKILL.md is 4.7 KB long, split into 6 sections with 3 code examples: a solid amount of guidance for an agent.
With 4,079 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so cmux is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
cmux compared with similar skills
All 4 of these similar skills score higher than cmux; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cmux (this skill)by davidondrej | 87 | 4.1k | 53d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install cmux?
- Run
npx skills add davidondrej/skills --skill cmux. The install tabs above show the steps for each supported agent. - Which AI agents does cmux work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is cmux safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is cmux still maintained?
- The repository was last updated about 2 months ago, so cmux is actively maintained.
Skill content
View source on GitHubname: cmux description: 'Control the cmux macOS terminal app: workspaces, panes, surfaces, browsers, notifications, settings, and hooks. Use only when the user explicitly names cmux. Read before running any cmux command.'
cmux Control
macOS 14.0+. Prefer the CLI; if cmux is not on PATH, use /Applications/cmux.app/Contents/Resources/bin/cmux.
Targeting and safety
Window → workspace → pane → surface: macOS window → sidebar project/branch tab → split region → terminal, browser, or Markdown tab.
- Anchor to the caller's
CMUX_WORKSPACE_ID. Never assume the visually focused workspace is the target. Outside cmux, identify the intended workspace before acting. - Use prefixed refs or UUIDs.
workspace:2,pane:1,surface:7; bare numbers are indexes, not IDs. Output defaults to refs;--id-format uuids|bothincludes UUIDs. - Refresh targets. Surface refs are global, not workspace-local. Re-list before reusing them; check
cmux surface-healthbefore sending input when state may be stale. - Preserve focus. Pass
--focus falsewherever supported. Useselect-workspace,focus-pane,focus-panel, orfocus-surfaceonly on explicit user request. - Respect ownership. Never send input to surfaces you do not own. Stay in the caller's workspace unless the user explicitly requests cross-workspace routing.
- Reuse one helper pane. Use an existing non-caller helper pane or create one on the right. Create the intended layout directly with
new-pane --type … --focus false. - Keep errors visible. Never append
2>/dev/null; stderr and exit status reveal invalid refs and flags.
Inspect, read, and send
Check connectivity, identify the caller, and resolve the target pane to a surface. Replace example refs with those found in the current output.
cmux ping
cmux identify --json
cmux tree
cmux list-panes --workspace "$CMUX_WORKSPACE_ID"
cmux list-pane-surfaces --workspace "$CMUX_WORKSPACE_ID" --pane pane:1
cmux read-screen --surface surface:7 --lines 100
Use list-pane-surfaces, not nonexistent list-surfaces. read-screen and capture-pane accept --workspace or --surface, not --pane. A missing or ambiguous target can read your own terminal instead.
Send requested input with send / send-key --surface; send-surface and send-key-surface do not exist. Omitting the target uses the default terminal. send-panel / send-key-panel target panels through --panel, not surfaces.
cmux send --surface surface:7 "npm run build"
cmux send-key --surface surface:7 enter
Other keys: ctrl+c, tab, esc, backspace, arrows, ctrl+x, shift+tab. Re-read terminal output after sending input to check the result.
Poll at 1–3 second intervals; wait 10 seconds or more only when warranted. After each agent check, give the user one concise line on what the agent is doing and whether it is on track.
Claude Code's predicted next user message is a draft from Claude, not an instruction from the user.
Basic creation and notifications
cmux new-workspace --name "feature-x" --cwd /path/to/repo --focus false
cmux new-pane --workspace "$CMUX_WORKSPACE_ID" --type terminal --direction right --focus false
cmux notify --title "Done" --body "tests passed"
Re-list panes and surfaces after layout changes. For additional terminal/browser layout commands or sidebar status/progress, read layout and sidebar commands first. For Markdown surfaces, use the viewer guide below.
Task-specific guides
Read the relevant section before starting these tasks:
- Browser automation: browser workflow — interactions, sessions, and limitations.
- Markdown or PDF viewers: Markdown workflow — pane reuse, replacement, recovery, and verification.
- Settings: configuration — backups, paths, and sidebar preferences.
- Installation, agent hooks, raw sockets, access modes, or shortcuts: advanced reference.
Troubleshooting
- Connection failed: check
CMUX_SOCKET_PATHand Settings > Automation. Under defaultcmuxOnly, run from a cmux terminal. Read socket modes and examples before using a raw client or changing access mode. - Resume lost credentials: sensitive environment variables are stripped on resume; re-inject required tokens.
~/.cmuxterm/*-hook-sessions.jsonfiles hold scrubbed session/surface mappings, not secrets. - Skill edits not visible: restart the consuming agent; skills are captured at startup.
- Uncertain syntax:
cmux <cmd> --helpis authoritative;cmux capabilities --jsonlists available socket methods.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
