cmux-orchestration

Manage cmux workspaces and agent fleets via command-line.

2|Updated Jun 2, 2024
One-click install
npx skills add https://github.com/magnusrodseth/dotfiles --skill cmux-orchestration-magnusrodseth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux-orchestration
Source: https://github.com/magnusrodseth/dotfiles/tree/main/.claude/skills/cmux-orchestration
Command: npx skills add https://github.com/magnusrodseth/dotfiles --skill cmux-orchestration-magnusrodseth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The cmux-orchestration Skill unit addresses the challenges of managing and controlling cmux (manaflow-ai/cmux) agent fleets, providing solutions to common issues that arise during the orchestration of cmux workspaces, panes, and surfaces from a command-line interface.

Core Features & Use Cases

  • Surface & Pane Management: Target specific surfaces or panes within a cmux workspace for commands, overcoming 'Surface not found' errors.
  • Agent Orchestration: Build and drive an agent team programmatically, ideal for headless and interactive agent operations.
  • Browser Command Correction: Includes workarounds for browser-related subcommand errors like 'Unsupported browser subcommand'.
  • Durable Configuration: The configuration lives in the dotfiles directory, surviving cmux updates, providing the latest verified corrections.
  • Quick Start for Interactive Sessions: Instructions to set up and use an interactive session with cmux agents from an external terminal.
  • External Terminal Compatibility: Guides users through setting socketControlMode to use cmux from an external terminal safely.

Quick Start

Run the command 'cmux-orchestration --create-agent-fleet' to launch an agent fleet, manage workspaces and panes with the correct flags for optimal interaction.

Frequently Asked Questions about cmux-orchestration

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

FAQPage Schema
How do I orchestrate cmux agent fleets from an external terminal?▼

You can orchestrate cmux agent fleets by using the `cmux-orchestration --create-agent-fleet` command. This sets up an interactive session and manages workspaces and panes with the correct flags for optimal interaction.

Why does cmux orchestration return a 'Surface not found' error?▼

A 'Surface not found' error occurs when commands are not correctly targeting specific surfaces or panes within a cmux workspace. Proper syntax and usage rules are required to direct commands to the intended surface.

What is the best way to manage cmux workspaces and panes via command-line?▼

The best way to manage cmux workspaces and panes via command-line is by using dedicated orchestration syntax. This provides CLI-based control to target specific surfaces and resolve common orchestration errors.

How do I fix the 'Unsupported browser subcommand' error in cmux?▼

To fix the 'Unsupported browser subcommand' error in cmux, apply the included browser command correction workarounds. These corrections address browser-related subcommand errors during agent orchestration.

Does cmux orchestration configuration survive cmux updates?▼

Yes, cmux orchestration configuration survives cmux updates because it lives in the dotfiles directory. This durable setup ensures the latest verified corrections persist across software updates.