cmux-team

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

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Derek-X-Wang/skills --skill cmux-team-derek-x-wang
Or copy as Structured Prompt for Agent
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.