Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cmux — Claude Code skill: window and pane control

Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux -a claude-code
Open on GitHub

What cmux does

cmux organizes layout as a hierarchy: window → workspace (tab) → pane (split) → surface (terminal or browser panel). The skill provides commands to build, navigate, and reorder: cmux new-workspace, cmux new-split right, cmux move-surface, cmux reorder-surface. When spawning a new terminal, the --command flag runs a command immediately in a live shell, no separate send needed.

Output defaults to short handles (window:1, pane:2), but the skill accepts UUIDs as input and can return them with --id-format uuids. Workspace colors, app behavior, and cmux settings live in ~/.config/cmux/cmux.json; cmux reload-config reloads both that file and Ghostty config without restarting. Font, theme, cursor, and scrollback belong in Ghostty config, not cmux settings.

The skill also inspects download history on browser surfaces and can trigger flash cues to grab attention. It is part of the cmux-skills family: separate skills cover browser automation, markdown viewing, settings validation, and window captures.

What it helps with

  • Route an agent into a specific pane and ensure focus
  • Spawn a new terminal with a command that runs immediately
  • Move a surface from one pane to another
  • Reorder workspaces and splits in a window
  • Get IDs of the current window, workspace, and pane

Example prompts for the agent

  • Create a new workspace and start npm dev in it
  • Move surface:7 to pane:2 and set focus
  • List all panes in the current workspace with their surfaces

How to install cmux

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux/

From the same set12

The whole set →
cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

figma-generate-design official openai Turns an app page or multi-section layout into a Figma screen built from your published design system, not hand-drawn boxes. Claude Code CX Codex Cursor +1 2,900installs figma-create-design-system-rules official openai Generates project-specific design system guidelines for AI coding agents handling Figma-to-code tasks. It inspects existing components and writes rules directly into your repository. Claude Code CX Codex Cursor +1 2,900installs task-observer Eoghan Henn and contributors Monitors agent execution, logs user corrections, and packages repeating workflows into skill updates during weekly reviews. Claude Code CX Codex Cursor +1 14,300installs search-strategy official anthropics This skill breaks a natural-language question into source-specific searches and combines the results. Use it for decisions, status checks, and document discovery. Claude Code CX Codex Cursor +1 5,300installs define-goal official openai Shapes vague requests into concrete, measurable goals with explicit pass criteria before an agent starts working. Claude Code CX Codex Cursor +1 2,800installs thermo-nuclear-code-quality-review cursor Runs a strict maintainability audit of code changes, abstractions, large files, and branching complexity. Use it when a routine review needs deeper structural scrutiny. Claude Code CX Codex Cursor +1 22,200installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs

Questions about cmux

How do I install cmux in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux -a claude-code, then find SKILL.md in ~/.claude/skills/cmux/.

What does cmux do?

The skill lets agents control cmux topology: create windows, workspaces, splits, and browser panels; move them; change focus; and run commands in new terminals directly from automation.

Do I need Ghostty?

cmux is built for Ghostty as the terminal. If Ghostty is not installed, cmux commands will not work.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor