cmux-agents

Manage AI agent lifecycles across multiple terminal panes with cmux.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/EtanHey/golems --skill cmux-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-agents
Source: https://github.com/EtanHey/golems/tree/main/skills/golem-powers/cmux-agents
Command: npx skills add https://github.com/EtanHey/golems --skill cmux-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of spawning, managing, and monitoring AI agents directly within terminal panes (cmux), enabling parallel work and visible agent activity across various AI CLIs.

Core Features & Use Cases

  • Parallel Agent Spawning: Launch multiple AI agents (Claude, Codex, Cursor, Gemini, Kiro) simultaneously in separate terminal panes for concurrent tasks.
  • CLI Agnostic Management: Provides a unified interface to interact with different AI command-line tools, abstracting away CLI-specific syntax.
  • Worktree Isolation: Enforces proper Git worktree isolation for parallel agents working on the same repository, preventing state conflicts.
  • Use Case: You need to perform a codebase-wide security audit with Cursor, refactor a module with Codex, and research a new pattern with Gemini, all at the same time. This Skill allows you to spawn each agent in its own cmux pane, manage their lifecycle, and monitor their progress.

Quick Start

Spawn a Claude agent in the golems repository to fix the search ranking issue.

Frequently Asked Questions about cmux-agents

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

FAQPage Schema
How do I run multiple AI agents in parallel terminal panes?

You can spawn and manage multiple AI agents in parallel terminal panes using cmux. This Skill handles agent lifecycle management, allowing you to launch CLIs like Claude, Codex, and Gemini simultaneously for concurrent tasks.

Can I manage different AI CLI tools like Claude and Codex from a single interface?

Yes, you can manage different AI CLI tools from a single interface. The Skill provides CLI-agnostic management, abstracting away CLI-specific syntax routing so you can interact with Claude, Codex, Cursor, Gemini, and Kiro uniformly.

How do I prevent Git state conflicts when running parallel AI agents on the same repository?

To prevent Git state conflicts during parallel agent execution, the Skill enforces Git worktree isolation. This ensures each AI agent operates within its own isolated worktree, avoiding overlapping changes in the same repository.

What do I need to set up before orchestrating terminal AI agents with cmux?

Orchestrating terminal AI agents requires cmux, shell scripting capabilities, and knowledge of individual AI CLI behaviors. You need these prerequisites to effectively manage agent spawning and monitoring across terminal panes.

Is there a way to monitor AI agent activity visually in the terminal?

Monitoring AI agent activity visually is achieved by spawning agents directly within cmux terminal panes. This setup provides visible agent activity, allowing you to track the progress of concurrent tasks across various AI CLIs.

What is the best way to coordinate a codebase security audit and a module refactor at the same time?

The best way to coordinate simultaneous tasks like a security audit and module refactor is parallel agent spawning. You can launch separate AI agents in their own cmux panes to handle concurrent codebase work without state conflicts.