cmux
Control cmux workspaces, panes, surfaces, and agent sessions safely from macOS terminal workflows.
Profile →npx skills add sickn33/agentic-awesome-skills --skill cmux --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# cmux Control ## When to Use - Use when you need to inspect, create, close, or rearrange cmux panes, surfaces, or workspaces. - Use when you need to send input to or monitor agents running inside cmux. 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/
- When to Use
- Core Concepts
- Ref syntax — get this right or fail silently
- Detect cmux in a Shell
- Fast Start — Topology
- Polling Pi Agents in Panes — Keep Sleeps Short
- Send Input
- Notifications & Sidebar Metadata
- Browser Automation (WKWebView)
- Markdown Viewer
- Reuse the existing right markdown pane (don't spawn strays)
- Swapping the file in the single right pane (close-FIRST, then open)
- Hard-won lessons (avoid the trial-and-error)
- Settings & Config
cmux identify --json # who am I (window/workspace/pane/surface) cmux tree # full hierarchy cmux list-workspaces --json cmux list-panes --workspace "$CMUX_WORKSPACE_ID" cmux list-surfaces --workspace "$CMUX_WORKSPACE_ID" cmux new-workspace --name "feature-x" --cwd /path/to/repo cmux new-pane --workspace "$CMUX_WORKSPACE_ID" --type terminal --direction right --focus false cmux new-pane --workspace "$CMUX_WORKSPACE_ID" --type browser --direction right --url http://localhost:3000 cmux move-surface --surface surface:7 --pane pane:2 --focus false cmux split-off --surface surface:7 right
What does the cmux skill do?
Control cmux workspaces, panes, surfaces, and agent sessions safely from macOS terminal workflows.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill cmux --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.