cmux-workspace

Community

Scope cmux automation to the caller workspace

Authordeerawan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents cmux automation from acting on the wrong window, workspace, pane, or terminal by consistently targeting the caller-scoped cmux context.

Core Features & Use Cases

  • Caller-scoped workspace targeting: Uses CMUX_WORKSPACE_ID and CMUX_SURFACE_ID as the default anchors to keep actions aligned with the invoking workspace and terminal.
  • Non-disruptive layout automation: Builds panes and surfaces additively and avoids speculative focus changes, so the user’s attention and visible layout are not disturbed.
  • Right-side helper pane management: Reuses an existing right-side helper pane when available; otherwise creates exactly one to host previews, logs, TUIs, or one-off shells.
  • Workspace-scoped status and sidebar output: Attaches progress, logs, and notifications to the current workspace for accurate sidebar reflection.

Quick Start

Use cmux-workspace to identify the current caller workspace and surface, then run workspace-scoped commands and send output to the caller surface while optionally creating or reusing a right-side helper pane for logs.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: cmux-workspace
Download link: https://github.com/deerawan/dotfiles/archive/main.zip#cmux-workspace

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.