cmux-pair

# cmux Pair Kick off a pair programming session between Claude and Codex over cmux. You are one of the two agents; the other is running in a different cmux surface. The full message protocol lives in your global config (`~/.codex/AGENTS.md` for Codex, `~/.claude/CLAUDE.md` for Claude) under "Pair Programming Protocol (cmux)" - read it before sending anything if you haven't already. This skill handles session bootstrap only. Once the first message is delivered, the protocol takes over on both sides. For cmux topology basics (handles, identify, surfaces, flash, health), see the `cmux` skill. This skill assumes you already know those primitives. ## When to use - User wants live peer collaboration with the other agent. - Both agents are already running in cmux surfaces (or the user is willing to start one). - The task benefits from back-and-forth: design review, debugging, cross-checking a plan. Not a fit for fire-and-forget delegation - use `codex-execute` / `codex-review` skills for that. They use background processes because `cmux send` is unreliable for long commands and creating new workspaces disorganizes the sidebar. Pair-program is for interactive sessions where both surfaces already exist. ## Steps ### 1. Identify yourself and the partner ```bash cmux --json --id-format both identify cmux list-pane-surfaces --workspace <caller.workspace_ref> ``` - Your surface is `caller.surface_ref` from `identify`. - Your hard workspace identity is the caller workspace UUID f...