cmux-team-dispatch-task

What problem does it solve?

Orchestrate parallel execution of multiple tasks across isolated git worktrees using cmux workspaces. Each task runs in its own Claude Code session, while a parent orchestrator monitors all child sessions. It dynamically discovers available agent types from .claude/agents/ and passes the list to child sessions, which select the appropriate agent themselves. Dispatches immediately without parent-side planning, enabling truly parallel brainstorming/planning and execution across 2+ independent tasks. It supports three layout modes—split, workspace, and claude-teams—and includes a robust status-reporting pipeline via .dispatch directories.

Core Features & Use Cases

• Dynamic discovery of available agents from .claude/agents/ and per-task agent selection by each child session
• Immediate parallel dispatch without parent-side planning, suitable for 2+ independent tasks
• Three layout modes: split (panes within current workspace), workspace (separate sidebars/workspaces), and claude-teams (Agent Teams)
• Per-task git worktrees and Claude Code sessions for isolation and reproducibility
• File-based status and result reporting via .dispatch, with optional monitoring and automated completion notes
• Flexible task intake from inline descriptions or plan references, enabling hybrid workflows

Quick Start

Provide a list of tasks and cmux will dispatch them in parallel across separate workspaces.

What problem does it solve?

Orchestrates parallel execution of multiple Claude Code tasks across independent workspaces, enabling fast, concurrent brainstorming, planning, and execution without sequential bottlenecks.

Core Features & Use Cases

• Discover and leverage available agents dynamically from .claude/agents/ for task-specific guidance
• Launch multiple tasks in parallel with deterministic isolation (git worktrees) and separate Claude Code sessions
• Support for split, workspace, and claude-teams layouts to optimize for task count, duration, and notifications
• Centralized progress tracking via the .dispatch directory and automated completion signaling
• Handles mixed task inputs (inline descriptions and plan references) with consistent prompt delivery

Quick Start

Provide a list of tasks and cmux will dispatch them in parallel across separate workspaces.