cmux-terminal-multiplexer — Claude Code skill: setup & overview
Equips AI agents with CLI commands for terminal split orchestration and headless Chromium browser actions via surface handles.
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a claude-codeWhat cmux-terminal-multiplexer does
This skill teaches coding agents to manage workspaces through cmux. The agent spins up horizontal or vertical panes using new-split right or new-split down, sends commands to designated targets like surface:22, and captures output with capture-pane. Targeting runs directly against explicit surface handles. That structure prevents unexpected window focus shifts while background jobs run.
A headless Chromium runtime comes embedded inside cmux, so configuring an external Chrome installation is unnecessary. Web actions rely on interactive snapshot identifiers such as e1 or e2 instead of standard CSS selectors. Because DOM updates invalidate these handles immediately, the agent must generate a fresh snapshot after clicks or navigation steps.
What it helps with
- Manage terminal splits side by side for concurrent command runs
- Run headless browser workflows without setting up an external Chrome
- Read terminal output and scrollback history by surface reference
- Execute browser actions using generated snapshot element references
Example prompts for the agent
- Open a right terminal split with cmux and run npm test
- Navigate to https://example.com using cmux browser and take an interactive snapshot
- Read the latest output from surface:12 with cmux capture-pane
How to install cmux-terminal-multiplexer
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a claude-code2Manually: put the files in place
~/.claude/skills/cmux-terminal-multiplexer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cmux-terminal-multiplexer/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a codex2Manually: put the files in place
.agents/skills/cmux-terminal-multiplexer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a cursor2Manually: put the files in place
.cursor/skills/cmux-terminal-multiplexer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills cmux-terminal-multiplexer2Manually: put the files in place
.github/skills/cmux-terminal-multiplexer/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/cmux-terminal-multiplexerManually: put the files in place
.devin/skills/cmux-terminal-multiplexer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cmux-terminal-multiplexer
How do I install cmux-terminal-multiplexer in Claude Code?
Run npx skills add reason-machines/trending-skills --skill cmux-terminal-multiplexer -a claude-code. The skill file is placed in ~/.claude/skills/cmux-terminal-multiplexer/SKILL.md.
What does cmux-terminal-multiplexer do?
It gives agents patterns to split terminal windows, send background inputs, inspect screen buffers, and automate an embedded browser.
Is an external Chrome installation required for browser automation?
No external Chrome binary is needed. The tool runs on an internal headless Chromium engine directly through CLI calls.