cmux

manaflow-ai/cmux · updated Apr 23, 2026

$npx skills add https://github.com/manaflow-ai/cmux --skill cmux
0 commentsdiscussion
summary

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
skill.md

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.
general reviews

Ratings

4.425 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

1 / 3