Individual skill
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.
ai_docs/cmux-skills/cmux-workspace/SKILL.md
Source commit 6eaacabbee4c71120f7cd161c9539530f84068a8
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 5, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 116
- Repository last updated
- Jun 29, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesSKILL.mdcore · 10,397 bytesagents/openai.yamlasset · 392 bytesreferences/commands.mddoc · 3,544 bytes
Read excerpt
# cmux Workspace
Use this skill when a task should be scoped to the cmux workspace that invoked the agent. A workspace is the sidebar tab-like unit in cmux. It contains split panes, and each pane contains one or more surfaces. A surface is the terminal or browser session the user interacts with.
## 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 cmux workspace is the right target. An agent can be running in one workspace while the user is looking at another. Prefer the caller environment first:
```bash
printf 'workspace=%s\nsurface=%s\nsocket=%s\n' \
"${CMUX_WORKSPACE_ID:-}" \
"${CMUX_SURFACE_ID:-}" \