cmux-workspace

Scope automation to the current cmux workspace and its surfaces.

25.8k|2.2k|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-workspace-manaflow-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-workspace
Source: https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-workspace
Command: npx skills add https://github.com/manaflow-ai/cmux --skill cmux-workspace-manaflow-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Work inside the current cmux workspace and terminal to scope automation and actions to the active context, preventing cross-workspace interference.

Core Features & Use Cases

  • Scope actions to the current caller workspace by default, including the current workspace, panes, and surfaces.
  • Target sockets, surfaces, and panes for cmux automation without leaving the active workspace.
  • Use for non-disruptive automation and coordination across the active cmux context.

Quick Start

Scope all automation to the current cmux workspace and its surfaces by default.

Frequently Asked Questions about cmux-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scope terminal automation to the active workspace and prevent cross-workspace interference?

You can scope automation by constraining actions to the current cmux caller workspace and its surfaces, ensuring operations respect CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, and CMUX_SOCKET_PATH to prevent cross-workspace interference.

What is a cmux workspace and when do I need to isolate automation context?

A cmux workspace is an isolated terminal context containing panes, surfaces, and sockets. You need to isolate automation context when running non-disruptive background tasks to prevent actions from leaking across workspace boundaries.

How do I target specific panes and surfaces for cmux automation without leaving the active workspace?

Target specific panes and surfaces by applying non-disruptive automation directly within the active workspace context, ensuring all socket and surface interactions respect the current CMUX_SURFACE_ID and CMUX_WORKSPACE_ID environment variables.

Can I explicitly target a different cmux workspace or surface than the active caller context?

Yes, you can explicitly target another workspace or surface, but by default all automation is constrained to the current cmux caller workspace to ensure non-disruptive coordination across the active context.

What environment variables does cmux workspace scoping rely on to constrain automation?

Cmux workspace scoping relies on CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, and CMUX_SOCKET_PATH to identify and constrain all automation actions to the active caller context and its surfaces.