One-click install
npx skills add https://github.com/deerawan/dotfiles --skill cmux-deerawan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/deerawan/dotfiles/tree/main/agents/skills/cmux
Command: npx skills add https://github.com/deerawan/dotfiles --skill cmux-deerawan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

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 navigation in multi-pane layouts?

Automate terminal routing in multi-pane layouts by using deterministic, handle-based commands to identify windows, workspaces, panes, and surfaces, then apply targeted move, split, and focus operations. This eliminates guesswork when reorganizing complex terminal environments.

What is deterministic workspace navigation for terminal multiplexer environments?

Deterministic workspace navigation targets specific terminal panes via unique handles and UUIDs rather than positional indices. It queries the current topology as JSON to identify stable targets, ensuring automation scripts place and focus surfaces reliably without visual guesswork.

How do I safely reload terminal configuration after updating workspace settings?

Safely reload terminal configuration after workspace settings updates by using the recommended settings docs command and reload flow. This procedure applies changes without disrupting unrelated terminal rendering settings or interrupting active multi-pane sessions.

Can I trigger visual cues to confirm pane placement during terminal automation loops?

Trigger visual cues to confirm pane placement during terminal automation loops by using a trigger-flash command. This provides immediate visual feedback on the targeted surface, verifying that deterministic routing and reordering operations executed correctly within the loop.

What is the best way to reorder panes and surfaces across multiple terminal workspaces?

The best way to reorder panes and surfaces across workspaces is using handle-based topology inspection to list targets, then executing deterministic move and reorder commands. This approach ensures precise layout reorganization without relying on manual navigation.