cmux-team

Coordinate Claude Code agent teammates as separate panels in cmux claude-teams sessions.

Updated Mar 21, 2026

Search Tags:#worktrees #orchestration #panels #agent-management #teammates #cmux #claude-teams

Ready to run

npx skills add https://github.com/Derek-X-Wang/skills --skill cmux-team-derek-x-wang

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cmux-team
Source: https://github.com/Derek-X-Wang/skills/tree/main/cmux-team
Command: npx skills add https://github.com/Derek-X-Wang/skills --skill cmux-team-derek-x-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate multiple Claude Code agent teammates within a cmux claude-teams session to surface as separate panels. In cmux-team mode, you gain parallel agent surfaces, orchestrated as discrete panels within the same session to streamline collaboration and testing.

Core Features & Use Cases

Spawns teammates as discrete panels within a cmux session and surfaces them as independent surfaces.
Supports isolated worktrees under .claude/worktrees/ to prevent code conflicts and provide clean diffs.
Defines teammate behavior via .claude/agents and a clear lead-teammate communication contract.

Quick Start

Spawn a team with the Agent tool using a descriptive team_name and then spawn teammates with team_name to surface them as panels.

Frequently Asked Questions about cmux-team

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

FAQPage Schema

How do I coordinate multiple Claude Code agents in separate panels?▼

To coordinate multiple Claude Code agents in separate panels, you can use a cmux claude-teams session to spawn teammates as discrete, parallel surfaces within the same session. This streamlines collaboration and testing across isolated agents.

How do I isolate agent code changes when running parallel teammates?▼

You can isolate agent code changes during parallel teammate execution by utilizing isolated worktrees stored under .claude/worktrees/. This prevents code conflicts between teammates and provides clean diffs for review.

How do I define custom behaviors for spawned Claude teammates?▼

You define custom behaviors for spawned Claude teammates by creating custom agent definitions under the .claude/agents directory. This establishes a clear lead-teammate communication contract for orchestrated sessions.

How do I spawn teammates in a cmux panel layout?▼

You spawn teammates in a cmux panel layout by launching a team with a descriptive team_name using the Agent tool, then spawning teammates with that team_name to surface them as independent panels within the session.

Do I need a specific environment to run cmux claude-teams sessions?▼

Yes, cmux claude-teams sessions require detection of the claude-teams environment to properly manage setup, spawning, and teardown. The skill's scope specifically covers sessions launched via cmux claude-teams.

What is the best way to manage agent collaboration and testing in Claude Code?▼

The best way to manage agent collaboration and testing in Claude Code is orchestrating teammates as discrete panels within a cmux session, providing parallel agent surfaces with a dedicated communication contract between orchestrator and teammates.