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 target: an agent can run in one workspace while the user looks at another.

printf 'workspace=%s\nsurface=%s\nsocket=%s\n' \
  "${CMUX_WORKSPACE_ID:-}" "${CMUX_SURFACE_ID:-}" "${CMUX_SOCKET_PATH:-}"
cmux identify --json