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.