cmux

Control cmux topology and routing across windows, workspaces, panes, and surfaces.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Aradotso/ara.engineer --skill cmux-aradotso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/Aradotso/ara.engineer/tree/main/skills/cmux
Command: npx skills add https://github.com/Aradotso/ara.engineer --skill cmux-aradotso

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

cmux provides end-user control of cmux topology and routing across windows, workspaces, panes, and surfaces to ensure deterministic placement and navigation in multi-pane layouts for automation.

Core Features & Use Cases

  • Manage windows, workspaces, panes, and surfaces: create, focus, move, and reorder to shape the UI topology.
  • Identify and target with stable handles: supports short refs and UUIDs to locate elements reliably in automation workflows.
  • Visual cues and health checks: trigger-flash for quick confirmation and surface health checks to guard against stale UI state.
  • Use cases include automating complex cmux topologies for multi-pane workflows, dashboards, and terminal/browser surfaces.

Quick Start

Identify the current topology, then create or focus a window/workspace/pane/surface and perform a move or reorder as needed.

Frequently Asked Questions about cmux

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

FAQPage Schema
How do I automate cmux window and pane layout deterministically?

You identify the current cmux topology, then create, focus, move, or reorder windows, workspaces, panes, and surfaces. This deterministic routing ensures automation workflows place elements reliably across multi-pane desktop layouts.

Can I target specific cmux panes using short refs or UUIDs in automation?

Yes, you can target specific cmux panes using short refs or UUIDs as stable handles. This allows automation scripts to reliably locate and route to elements without relying on positional coordinates.

How do I verify cmux routing and navigation actions during automation?

Verify cmux routing actions by using the trigger-flash feature for visual confirmation. Additionally, surface health checks guard against stale UI state to ensure your automation targets are active and valid.

What's the best way to manage multi-pane terminal and browser surfaces for dashboards?

Manage multi-pane dashboards by shaping the UI topology across terminal and browser surfaces. You create and reorder workspaces and panes to build complex layouts, ensuring quick switching and precise navigation for your automation needs.

Does cmux topology control work across different desktop environments?

Yes, cmux topology control applies to automation scenarios across desktop environments. It manages windows, workspaces, panes, and surfaces to ensure deterministic layout and quick switching regardless of the specific desktop context.