skill CX Codex

cmux-workspace · manaflow-ai — Claude Code skill: work in the current cmux workspace

Q: How do I install cmux-workspace in Claude Code?

Run `npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-code`. The skill file then lives at `~/.claude/skills/cmux-workspace/SKILL.md`.

Keeps an agent's actions inside the cmux workspace and terminal that started it, so automation does not disturb whatever the user is looking at.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

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

Open on GitHub

What cmux-workspace does

The skill lays out cmux's structure for the agent: window, workspace, pane, surface. Unless the user names another target, every action stays in the caller's workspace rather than the one on screen. Anchors come from CMUX_WORKSPACE_ID and CMUX_SURFACE_ID; when those are absent, the agent falls back to cmux identify --json and says it is using the focused context.

Layout is built in one pass with panes that already carry the right surface, and --command starts the first command at spawn instead of a later send. Verbs that move focus or switch workspaces count as user-facing clicks, so the skill never calls them on a guess. Auxiliary output — a preview app, logs, a throwaway shell — goes into a single pane beside the caller's terminal; asking again adds a tab there instead of another split.

One rough edge is documented: drag-surface-to-split resolves the workspace through UI focus, so it returns ERROR: Surface not found when the caller's workspace is not the focused one. Recovering by focusing is off the table — report the failure and stop. Socket access may be disabled or limited to processes cmux spawned; cmux capabilities --json and cmux ping help diagnose that.

What it helps with

run a build in the workspace that launched the agent, not the visible one
open an app preview in a side pane without stealing focus
pass a note to another agent without typing into its terminal
show task status and progress in the current workspace sidebar
move a surface into a pane without changing focus

Example prompts for the agent

Run npm run dev in the terminal of the current cmux workspace
Open the preview at http://127.0.0.1:8765 in the right-hand pane, leave focus alone
Message the cmux-remote-status agent that the fix is on main

How to install cmux-workspace

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-workspace -a codex

2Manually: put the files in place

.agents/skills/cmux-workspace/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-workspace -a cursor

2Manually: put the files in place

.cursor/skills/cmux-workspace/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install manaflow-ai/cmux cmux-workspace

2Manually: put the files in place

.github/skills/cmux-workspace/SKILL.md

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-workspace -a gemini-cli

2Platform CLI

gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-workspace

Manually: put the files in place

.devin/skills/cmux-workspace/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-workspace -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cmux-workspace

How do I install cmux-workspace in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-code. The skill file then lives at ~/.claude/skills/cmux-workspace/SKILL.md.

What does cmux-workspace do?

It scopes the agent to the cmux workspace and terminal that invoked it: layout grows additively, and focus or workspace switches happen only when the user asks.

Why does drag-surface-to-split fail with ERROR: Surface not found?

That verb resolves the workspace through UI focus, so it breaks when the caller's workspace is not the focused one. The skill recommends building layout with cmux new-pane and reporting the failure instead of focusing to recover.

cmux-workspace by other authors comes first.

cmux-workspace manaflow-ai Keeps agent actions inside the cmux workspace that invoked it: panes, surfaces, socket, artifact previews. CX Codex +1 755installs 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. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs 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. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set24

The whole set →

cmux 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. CX Codex +1 9,700installs cmux-browser Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. CX Codex +1 8,800installs cmux-markdown Opens Markdown files in a formatted panel beside the terminal and reloads the view when files change. Useful for plans, notes, and docs. CX Codex +1 7,500installs cmux-settings A skill that reads and edits cmux settings in ~/.config/cmux/cmux.json: terminal, browser, Markdown, diff, notes and shortcuts. CX Codex +1 7,300installs cmux-customization Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. CX Codex +1 6,700installs cmux-diagnostics 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. CX Codex +1 6,400installs cmux-keyboard-shortcuts Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. CX Codex +1 6,200installs cmux-dev-workflow This skill guides native cmux work, from repository setup to tagged app builds and sidebar extension checks. Use it when changing native build inputs. CX Codex +1 4,900installs