cmux

Routes cmux windows, workspaces, panes, and surfaces via deterministic topology operations.

Updated Mar 11, 2026

Search Tags:#cmux #layout automation #terminal routing #deterministic navigation #focus control #workspace panes #surface health

Ready to run

npx skills add https://github.com/selfagency/agentsy --skill cmux-selfagency

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/selfagency/agentsy/tree/main/.agents/skills/cmux
Command: npx skills add https://github.com/selfagency/agentsy --skill cmux-selfagency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

cmux control automates deterministic window/workspace/pane/surface placement and navigation, reducing errors from manual clicking in multi-pane layouts.

Core Features & Use Cases

Topology inspection and targeting: Identify current context and address windows, workspaces, panes, and surfaces using stable short refs or UUIDs.
Deterministic routing and layout changes: Create, focus, move, split, reorder, and route focus without relying on fragile UI state.
Automation-friendly verification: Trigger flash for visual confirmation and run surface health checks to avoid routing stale or hidden surfaces.

Quick Start

Use the skill to list the current cmux topology and identify the focused window, workspace, pane, and surface as JSON.

Frequently Asked Questions about cmux

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

FAQPage Schema

How do I automate terminal routing and layout control for multi-pane workspaces?▼

Terminal routing and layout control for multi-pane workspaces is automated by inspecting the focused context and performing deterministic routing operations on windows, panes, and surfaces. This approach eliminates errors from manual clicking in complex layouts.

What is the best way to programmatically focus and rearrange terminal panes?▼

The best way to programmatically focus and rearrange terminal panes is through deterministic routing operations that target surfaces using stable short refs or UUIDs. This ensures stable placement without relying on fragile UI state.

How do I verify terminal pane placement and avoid routing stale surfaces during automation?▼

To verify terminal pane placement and avoid routing stale surfaces, you can trigger a flash for visual confirmation and run surface health checks. These automation-friendly features ensure safe navigation across hidden or active panes.

Can I target specific workspaces and panes using short references instead of manual selection?▼

Yes, you can target specific workspaces and panes using stable short refs or UUIDs. This deterministic navigation method addresses windows, workspaces, panes, and surfaces directly, bypassing the need for manual UI selection.

Why does deterministic focus control matter for terminal and browser panel orchestration?▼

Deterministic focus control matters for terminal and browser panel orchestration because it applies stable placement to multi-pane navigation. It reduces layout automation errors by ensuring routing commands hit the intended context every time.

Do I need a specific CLI command workflow to split and reorder panes in cmux?▼

Yes, you need SKILL.md-defined cmux CLI command workflows to split, reorder, and route focus. The skill uses these defined workflows to execute deterministic routing operations across the terminal topology safely.