cmux-workspace
Work inside the current cmux workspace and terminal. Use for cmux workspace, current workspace, caller surface, panes, surfaces, socket targeting, and non-interfering cmux automation.
Before you install
- Last update
- Files in folder
- 3
- Scripts
- No script files found
- SKILL.md size
- 7.9 KB (about 2,019 tokens of context each time it loads)
- License
- No license file
- Source on GitHub
- manaflow-ai/cmux
Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.
Install
npx skills add manaflow-ai/cmux@cmux-workspaceRuns in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.
Install for your agent
npx skills add manaflow-ai/cmux@cmux-workspace --agent claude-code -y- Project install writes to
.claude/skills/cmux-workspace- Global install writes to
~/.claude/skills/cmux-workspace
Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /cmux-workspace.
What it does
cmux Workspace Scope work to the cmux workspace that invoked the agent. - Window: a macOS cmux window. - Workspace: a sidebar entry. The UI calls it a tab; CLI/socket APIs call it a workspace. - Pane: a split region inside a workspace. - Surface: a tab inside a pane, terminal or browser. - Panel: internal content type inside a surface. Prefer CLI surface commands over panel internals. Default rule Scope actions to the current caller workspace unless the user explicitly asks for another workspace, another window, or global state. Do not assume the visually focused workspace is the right…
Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.
Categories
Related skills
- cmux
manaflow-ai/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.
- cmux-browser
manaflow-ai/cmux
End-user browser automation with cmux. Use when you need to open sites, inspect or interact with browser surfaces, wait for page state, and extract data without stealing focus.
- cmux-markdown
manaflow-ai/cmux
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).
- cmux-settings
manaflow-ai/cmux
View and edit cmux settings in ~/.config/cmux/cmux.json, including terminal, browser, Markdown, diff, notes, HTML, file preview, and sidebar-tool behavior. Use when the user wants to change cmux preferences, set a value by JSON path, validate the file, open it in an editor, or look up which keys cmux recognizes. Triggers on '/cmux-settings', 'change cmux setting', 'customize viewer', 'set <something> in cmux', 'cmux config', 'cmux.json', or 'rebind a cmux shortcut'.
- cmux-customization
manaflow-ai/cmux
Customize cmux for an end user, including terminal, browser, Markdown, diff, file preview, notes, HTML, and right-sidebar viewers. Use when changing cmux.json actions, custom commands, workspace layouts, plus-button behavior, surface tab bar buttons, Command Palette entries, Dock controls, sidebar and app settings, shortcuts, notifications, browser routing, examples-library presets, or Ghostty-backed terminal preferences.
- cmux-diagnostics
manaflow-ai/cmux
Run end-user cmux diagnostics. Use when cmux hooks, notifications, session restore, settings, browser automation, socket access, CLI control, or agent resume behavior is not working, or when the user asks for a cmux health check, doctor report, or support-safe debug summary.