Cmux

MUST be read ANY time you interact with cmux in ANY way — listing/inspecting/creating/closing cmux workspaces, panes, or surfaces; reading or capturing pane/screen output; sending input or keys to a pane/surface; delegating to, polling, or checking on other agents running in cmux panes/surfaces; building or rearranging terminal layout; cmux browser automation; sending notifications/flashes/status/progress to the sidebar; editing cmux settings; or integrating an agent with cmux hooks. If your command starts with `cmux ` or touches a cmux workspace/pane/surface/agent, read this FIRST. Triggers o

9 stars 1 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add matyasstoch/cmux-skill --skill cmux
Manual install
git clone --depth 1 https://github.com/matyasstoch/cmux-skill.git /tmp/cmux-skill
mkdir -p ~/.claude/skills
cp -r /tmp/cmux-skill/cmux ~/.claude/skills/cmux

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# cmux Control

cmux is a native macOS terminal app for running multiple AI coding agents in parallel. It exposes a CLI (`cmux`) and a Unix-socket JSON-RPC API (`/tmp/cmux.sock`) for full topology and browser control.

## Core Concepts

- **Window** — top-level macOS cmux window
- **Workspace** — sidebar tab within a window (one git branch / project context)
- **Pane** — split region inside a workspace
- **Surface** — tab inside a pane (terminal or browser)

Handles default to short refs (`workspace:2`, `pane:1`, `surface:7`); UUIDs accepted as input. Add `--id-format uuids|both` for UUID output.

### Ref syntax — get this right or fail silently

- **Always use PREFIXED refs** (`pane:38`, `surface:46`). A **bare number is treated as an INDEX, not an ID** — `--surface 46` means "the surface at index 46" (usually nonexistent → silent failure), NOT `surface:46`.
- **`read-screen` and `capture-pane` have NO `--pane` flag** — they target `--workspace` or `--surface` only. Passing `--pane` errors, and a bare/missing target falls back to your OWN surface (you'll read your own footer and draw wrong conclusions). To read a pane: resolve it to a surface FIRST with `cmux list-pane-surfaces --pane pane:N`, then `cmux read-screen --surface surface:N`.
- **Never append `2>/dev/null` to cmux commands.** Errors go to stderr with exit code 1; suppressing them blinds you to your own ref/flag mistakes (the #1 cause of "(no output)").

## Detect cmux in a Shell
Read the full skill on GitHub

Details

Skill name
cmux
Path
cmux/SKILL.md
Repo updated
15 June 2026
Copies
Found in 2 GitHub repos

FAQ

What does the Cmux skill do?

MUST be read ANY time you interact with cmux in ANY way — listing/inspecting/creating/closing cmux workspaces, panes, or surfaces; reading or capturing pane/screen output; sending input or keys to a pane/surface; delegating to, polling, or checking on other agents running in cmux panes/surfaces; building or rearranging terminal layout; cmux browser automation; sending notifications/flashes/status/progress to the sidebar; editing cmux settings; or integrating an agent with cmux hooks. If your command starts with `cmux ` or touches a cmux workspace/pane/surface/agent, read this FIRST. Triggers o

How do I install the Cmux skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add matyasstoch/cmux-skill --skill cmux. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Cmux popular?

It lives in matyasstoch/cmux-skill, which has 9 GitHub stars and 1 forks, and is included in 2 curated skill lists.

Related skills

Context Engine

40

ArogyaReddy/alirezarezvani-claude-skills

Loads and manages company context for all C-suite advisor skills. Reads ~/.claude/company-context.md, detects stale context (>90 days), enriches context during conversations, and enforces privacy/anonymization rules before external API calls.

AI, LLMs & Agents11

Claude Code Window Primer

46

zocomputer/skills

Optimize Claude Code Pro/Max usage by starting the 5-hour rolling window early morning, giving you more resets during waking hours.

AI, LLMs & Agents56

Cs Onboard

40

ArogyaReddy/alirezarezvani-claude-skills

Founder onboarding interview that captures company context across 7 dimensions. Invoke with /cs:setup for initial interview or /cs:update for quarterly refresh. Generates ~/.claude/company-context.md used by all C-suite advisor skills.

AI, LLMs & Agents11

Agent Protocol

40

ArogyaReddy/alirezarezvani-claude-skills

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, and response formats. Use when C-suite agents need to query each other, coordinate cross-functional analysis, or run board meetings with multiple agent roles.

AI, LLMs & Agents11

Handoff

46

zocomputer/skills

Pause-and-resume system for cross-conversation continuity. Use when your AI needs the user's input to continue a task but the current conversation must end. Checked on every boot to detect pending handoffs. Triggers on conversation start (boot check) and when the AI explicitly needs to pause for input.

AI, LLMs & Agents56

Team Digest

44

jiahao-shao1/sjh-skills

Help a team communicate through its agents, without progress reports. Each agent commits what it did to its own branch; when something needs aligning or deciding, each side sets out its approach in a topic issue; when someone wants to know what others are doing, an agent reads their branches and related issues and explains it in one screen. People decide. Use for 'team digest', 'what is X working on', 'what did the team do this week', 'who is waiting on whom', 'open an issue to align', 'set out my approach', '团队摘要', '某人在干什么', '大家这周做了什么', '谁在等谁', '开个 issue 对齐', '摆一下我的做法', '和队友对齐'. Not for coord

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.