What problem does it solve?
It eliminates guesswork when navigating or reorganizing complex cmux multi-pane layouts by giving deterministic, handle-based control over windows, workspaces, panes, and surfaces.
Core Features & Use Cases
- Topology inspection for stable targeting: Identify the current layout and list windows, workspaces, panes, and surfaces to choose the right targets.
- Deterministic routing and navigation: Create, focus, move, split, reorder, and trigger visual cues (flash) to confirm placement in an automation loop.
- Safer configuration workflow: Guide changes to cmux-owned settings by using the settings docs command and reload flow so updates apply without disrupting unrelated terminal rendering settings.
Quick Start
Ask an agent to identify the current cmux topology as JSON, then move surface surface:7 into workspace workspace:2 and focus it.