Agent skill

cmux

End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.

Stars 13,747
Forks 1,003

Install this agent skill to your Project

npx add-skill https://github.com/manaflow-ai/cmux/tree/main/skills/cmux

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

bash
# 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

Expand your agent's capabilities with these related and highly-rated skills.

manaflow-ai/cmux

release

Prepare and ship a cmux release end-to-end: choose the next version, curate user-facing changelog entries, bump versions, open and monitor a release PR, merge, tag, and verify published artifacts. Use when asked to cut, prepare, publish, or tag a new release.

13,747 1,003
Explore
manaflow-ai/cmux

cmux-debug-windows

Manage cmux debug windows and related debug menu wiring for Sidebar Debug, Background Debug, and Menu Bar Extra Debug. Use this when the user asks to open/tune these debug controls, add or adjust Debug menu entries, or capture/copy a combined debug config snapshot.

13,747 1,003
Explore
manaflow-ai/cmux

cmux-markdown

Open markdown files in a formatted viewer panel with live reload. Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering (headings, code blocks, tables, lists).

13,747 1,003
Explore
manaflow-ai/cmux

cmux-browser

End-user browser automation with cmux. Use when you need to open sites, interact with pages, wait for state changes, and extract data from cmux browser surfaces.

13,747 1,003
Explore
davila7/claude-code-templates

verl-rl-training

Provides guidance for training LLMs with reinforcement learning using verl (Volcano Engine RL). Use when implementing RLHF, GRPO, PPO, or other RL algorithms for LLM post-training at scale with flexible infrastructure backends.

23,776 2,298
Explore
davila7/claude-code-templates

openrlhf-training

High-performance RLHF framework with Ray+vLLM acceleration. Use for PPO, GRPO, RLOO, DPO training of large models (7B-70B+). Built on Ray, vLLM, ZeRO-3. 2× faster than DeepSpeedChat with distributed architecture and GPU resource sharing.

23,776 2,298
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results