What problem does it solve? Automating multi-pane terminal layouts requires deterministic placement and navigation, which manual window management cannot provide. This Skill gives agents precise control over cmux topology so they can create, move, focus, and reorder windows, workspaces, panes, and surfaces programmatically. ## Core Features & Use Cases - Topology Inspection: Identify the current caller context and list windows, workspaces, panes, and surfaces using short refs or UUIDs. - Layout Manipulation: Create splits, move or reorder surfaces across panes and workspaces, and manage window/workspace lifecycles. - Workspace Customization: Run context-menu actions such as setting colors, descriptions, renames, and pins on workspaces. - Attention and Health Checks: Trigger visual flash cues on surfaces and detect hidden or detached surfaces before routing input. - Use Case: An automation agent needs to split off a build log surface into its own pane, move it to a dedicated workspace, and flash it when the build completes, all without disrupting the user's focus. ## Quick Start Ask the agent to identify the current cmux context and list all panes and surfaces in the active workspace.
