Claude Code Swarm Orchestration

Master multi-agent orchestration using Claude Code's TeammateTool and Task system.

Primitives

Primitive	What It Is	File Location
Agent	A Claude instance that can use tools. You are an agent. Subagents are agents you spawn.	N/A (process)
Team	A named group of agents working together. One leader, multiple teammates.	`~/.claude/teams/{name}/config.json`
Teammate	An agent that joined a team. Has a name, color, inbox. Spawned via Task with `team_name` + `name`.	Listed in team config
Leader	The agent that created the team. Receives teammate messages, approves plans/shutdowns.	First member in config
Task	A work item with subject, description, status, owner, and dependencies.	`~/.claude/tasks/{team}/N.json`
Inbox	JSON file where an agent receives messages from teammates.	`~/.claude/teams/{name}/inboxes/{agent}.json`
Message	A JSON object sent between agents. Can be text or structured (shutdown_request, idle_notification, etc).	Stored in inbox files
Backend	How teammates run. Auto-detected: `in-process` (same Node.js, invisible), `tmux` (separate panes, visible), `iterm2` (split panes in iTerm2). See Spawn Backends.	Auto-detected based on environment