Guides cmux CLI usage and routes to dedicated cmux skills via live help output.
npx skills add https://github.com/psw7205/skills --skill cmux-help-psw7205
Please help me install this Agent Skill. Skill: cmux-help Source: https://github.com/psw7205/skills/tree/main/skills/cmux-help Command: npx skills add https://github.com/psw7205/skills --skill cmux-help-psw7205
cmux --help output. ## Core Features & Use Cases - Live-first documentation: Directs you to cmux --help, cmux docs <topic>, and cmux capabilities instead of guessing command syntax, preventing stale-doc errors. - Routing to dedicated skills: Acts as the entry point to official cmux skills (cmux-browser, cmux-settings, cmux-workspace, etc.) with a fallback chain (dedicated skill → raw SKILL.md URL via cmux docs → --help) that works even when no dedicated skill is installed. - Stable concepts and pitfalls: Documents the 4-layer hierarchy (Window → Workspace → Pane → Surface), handle formats, CMUX_* environment variables, and frequent mistakes like forgetting send-key Enter after send or reusing stale browser snapshot refs. - Use Case: You want to run tests in one cmux surface and read the output. The Skill gives you the exact send → send-key Enter → sleep → read-screen workflow and warns you about timing pitfalls. ## Quick Start Ask the AI to show how to run a command in a cmux surface and read its output using the cmux CLI.High-intent search queries and answers about installing and using this skill.
Use cmux send with the surface ref to type the command, then cmux send-key Enter separately to execute it, since send alone does not run anything. After a short sleep or completion-pattern poll, call cmux read-screen with --lines to capture the result.
cmux is a macOS-native app controlled over a Unix socket, while tmux is a traditional terminal multiplexer. cmux renames sessions to workspaces, splits send-keys into send plus send-key Enter, uses direction names for splits, and adds surfaces (tabs mixing terminal, browser, and markdown) inside panes.
cmux send only types text into the surface; it never presses Enter. You must call cmux send-key Enter as a separate command afterward. This is the most common cmux mistake.
Interactive snapshot refs like e1 and e2 become stale whenever the DOM changes through navigation or Ajax updates. After any action that modifies the page, take a fresh snapshot before referencing elements again.
Yes, but the CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, and related environment variables are only set inside cmux terminals. From outside, pass --workspace and --surface explicitly, and verify the app is running with cmux ping first.
The cmux browser is WKWebView-based, so it does not support viewport emulation, network interception, or trace recording. For those capabilities, use CDP-based tools like Playwright instead.
mrmtsuruyaAutomate cmux terminal multiplexer sessions on macOS.
AbsolutelySkilledOrchestrate cmux terminals and surfaces to automate multi-pane workflows.
merongAutomate cmux terminal layouts, browser interactions, and notifications via its socket API.
JansenAnalyticsSend keystrokes and capture pane output from tmux sessions.