agent-teams

This Skill addresses the lack of a unified coordination mechanism when multiple Claude processes work in parallel. In practical development, a single Claude session is limited by its context window and reasoning depth, making it difficult to simultaneously handle tasks that require parallel progress—such as large-scale refactoring, multi-module development, or code reviews—while manually managing multiple terminal windows often leads to task conflicts and progress confusion.

Usage is straightforward: you simply define a team configuration file (containing member roles, identity tags, and colors) and then start the team with a natural language command. The Skill automatically creates a tmux multi-pane session, with each Claude instance running independently. Communication occurs via JSON files in the ~/.claude/teams/ directory, using fcntl file locks to ensure concurrency safety. All tasks are written with incremental numbering into the tasks/ subdirectory. You can then assign tasks with commands like "Have the frontend agent implement the login module while the backend agent concurrently writes the API." Each agent works asynchronously and writes its results.

It is particularly well-suited for teams or individuals engaged in parallel development, multi-agent code review, large-scale refactoring, or cross-module collaboration. This tool is especially valuable for developers who already use the Claude CLI for daily coding but want to overcome the concurrency bottleneck of a single process, as well as for project managers who need to handle multiple independent subtasks simultaneously.

We recommend prioritizing this tool when tasks have natural parallelism (e.g., modifying multiple files, developing independent modules) and avoiding it for small tasks that require tight sequential reasoning, as that would introduce unnecessary overhead. Note that it depends on tmux and the Claude CLI, requires setting the environment variable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, and—due to file I/O latency—is not suitable for high-frequency, real-time communication scenarios.