cmuxlisted

# cmux Control cmux is a **third-party** native macOS terminal app (`manaflow-ai/cmux`) 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. ## Requirements (check before doing anything) - **macOS 14.0+ only.** No Linux/Windows port — if the host isn't macOS, this skill does not apply. - **The cmux app must be installed** (see [Agent Hooks & Install](#agent-hooks--install)). If the socket is absent, bail silently rather than erroring: ```bash [ -S "${CMUX_SOCKET_PATH:-/tmp/cmux.sock}" ] || exit 0 # not in cmux → nothing to do [ -n "${CMUX_WORKSPACE_ID:-}" ] && echo "inside cmux surface" ``` Injected env vars in every cmux-spawned terminal: `CMUX_WORKSPACE_ID`, `CMUX_SURFACE_ID`, `CMUX_SOCKET_PATH`, `CMUX_PORT`. **Always anchor automation to `CMUX_WORKSPACE_ID`** — the visually focused workspace may not be the agent's caller workspace. ## 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. ## Fast Start — Topology ```bash cmux identify --json # who am I (window/workspace/pane/surface) cmux tree