Cmux

What it does

The Cmux skill allows an AI agent to control a macOS cmux topology, managing windows, workspaces, panes, and surfaces within the cmux environment. It enables actions like creating new workspaces or splits, moving and reordering surfaces (tabs), focusing on specific elements, and triggering visual cues. This skill is designed for users who rely on cmux for window management and need an automated way to interact with its features.

When to use it

• Automating the creation of a standard workspace layout upon application startup.
• Moving a surface (tab) to a specific pane when new information appears.
• Triggering a visual flash on a particular surface to draw attention to an important event.
• Reordering surfaces within a pane to prioritize certain tasks or windows.

Key capabilities

• Window Management: Listing and manipulating cmux windows.
• Workspace Management: Creating, listing, and reordering workspaces.
• Pane Management: Creating splits (panes) within workspaces.
• Surface Management: Moving, reordering, focusing on, and triggering visual cues on surfaces (tabs).
• Identification: Identifying the current context using cmux identify --json.
• UUID Support: Accepting UUIDs as inputs or requesting output in UUID format (--id-format uuids|both).

Example prompts

• "Create a new workspace."
• "Move surface 7 to pane 2 and focus on it."
• "List all windows currently open."
• "Trigger a flash on surface 7."

Tips & gotchas

• The skill uses short references (e.g., window:N, workspace:N) by default, but UUIDs are also accepted as input. Use --id-format uuids|both when needing UUID output.
• Familiarize yourself with the cmux concepts of Windows, Workspaces, Panes, and Surfaces for effective control.