cmux-orchestration

Coordinate terminal agent workers across cmux panes and verify their reported changes.

Updated May 28, 2026
One-click install
npx skills add https://github.com/haryelramalho/skills --skill cmux-orchestration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-orchestration
Source: https://github.com/haryelramalho/skills/tree/main/skills/community/cmux-orchestration
Command: npx skills add https://github.com/haryelramalho/skills --skill cmux-orchestration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the coordination burden of running multiple terminal-based coding agents by giving a controller agent a clear protocol for launching, directing, monitoring, and verifying workers in cmux.

Core Features & Use Cases

  • Workspace-scoped orchestration: Keeps actions inside the caller workspace and avoids disruptive focus changes.
  • Worker lifecycle management: Starts Claude Opus and Codex GPT-5.5 workers, tracks their surfaces, and manages their status.
  • Evidence-based verification: Requires workers to report files, commands, diffs, and failures so the controller can validate results before acceptance.
  • Use cases: Branch review, bounded refactors, test execution, investigation of complex bugs, and multi-agent task delegation.

Quick Start

Use the cmux orchestration skill to coordinate Claude Opus and Codex GPT-5.5 workers for the current workspace, then verify their reported changes before integrating them.

Frequently Asked Questions about cmux-orchestration

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

FAQPage Schema
How do I coordinate multiple terminal coding agents like Claude and Codex in a single workspace?

Multi-agent orchestration coordinates terminal workers across cmux panes to delegate bounded tasks, monitor status, and consolidate results. A controller agent launches Claude Opus and Codex GPT-5.5 TUIs, tracks their state, and verifies reported changes.

Can I use cmux to manage Claude Opus and Codex GPT-5.5 workers simultaneously?

Yes, cmux manages Claude Opus and Codex GPT-5.5 workers simultaneously by applying explicit workspace, pane, and surface targeting. It enforces strict worker state tracking and non-disruptive focus rules to prevent terminal conflicts.

What is the best way to verify terminal agent worker results before integrating code changes?

Evidence-based verification requires workers to report cited files, commands, and diffs. The controller agent validates these reported changes and failures before accepting and integrating the results into the local development workflow.

How do I delegate bounded refactoring tasks across multiple agents in a local development environment?

You delegate bounded refactoring tasks by using a controller agent to launch, direct, and monitor terminal workers in cmux. The controller surfaces workers, assigns bounded scopes, collects evidence, and consolidates the verified results.

Does multi-agent terminal orchestration require explicit workspace and pane targeting?

Yes, explicit workspace, pane, and surface targeting is required. This strict targeting keeps actions inside the caller workspace and enforces non-disruptive focus rules to avoid unwanted terminal focus changes during agent execution.

When should I not use cmux orchestration for delegating coding tasks?

You should avoid cmux orchestration for unbounded or loosely defined tasks, as the protocol requires strict worker state tracking and bounded task delegation. The controller needs specific scopes to properly launch, monitor, and verify workers.