cmux▌
manaflow-ai/cmux · updated Apr 23, 2026
Deterministic control of cmux window, workspace, pane, and surface topology for multi-pane layout automation.
- ›Commands cover window and workspace creation, pane splitting, surface movement and reordering, focus routing, and visual attention cues via flash triggers
- ›Uses short reference handles (window:N, workspace:N, pane:N, surface:N) by default; supports UUID input and output when needed
- ›Designed for automation workflows requiring precise, repeatable placement and navigation across
cmux Core Control
Use this skill to control non-browser cmux topology and routing.
Core Concepts
- Window: top-level macOS cmux window.
- Workspace: tab-like group within a window.
- Pane: split container in a workspace.
- Surface: a tab within a pane (terminal or browser panel).
Fast Start
# identify current caller context
cmux identify --json
# list topology
cmux list-windows
cmux list-workspaces
cmux list-panes
cmux list-pane-surfaces --pane pane:1
# create/focus/move
cmux new-workspace
cmux new-split right --panel pane:1
cmux move-surface --surface surface:7 --pane pane:2 --focus true
cmux reorder-surface --surface surface:7 --before surface:3
# attention cue
cmux trigger-flash --surface surface:7
Handle Model
- Default output uses short refs:
window:N,workspace:N,pane:N,surface:N. - UUIDs are still accepted as inputs.
- Request UUID output only when needed:
--id-format uuids|both.
Deep-Dive References
| Reference | When to Use |
|---|---|
| references/handles-and-identify.md | Handle syntax, self-identify, caller targeting |
| references/windows-workspaces.md | Window/workspace lifecycle and reorder/move |
| references/panes-surfaces.md | Splits, surfaces, move/reorder, focus routing |
| references/trigger-flash-and-health.md | Flash cue and surface health checks |
| ../cmux-browser/SKILL.md | Browser automation on surface-backed webviews |
| ../cmux-markdown/SKILL.md | Markdown viewer panel with live file watching |
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.4★★★★★25 reviews- ★★★★★Amelia Nasser· Nov 15, 2024
Solid pick for teams standardizing on skills: cmux is focused, and the summary matches what you get after install.
- ★★★★★Arya Nasser· Oct 22, 2024
cmux reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Amelia Chen· Oct 6, 2024
cmux has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Zaid Nasser· Sep 17, 2024
Useful defaults in cmux — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Min Taylor· Sep 13, 2024
I recommend cmux for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Oshnikdeep· Sep 9, 2024
We added cmux from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Ganesh Mohane· Aug 28, 2024
cmux fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Aisha Agarwal· Aug 8, 2024
I recommend cmux for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Min Sethi· Aug 4, 2024
Useful defaults in cmux — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Yash Thakker· Jul 27, 2024
cmux has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 25