orchestrate

Coordinating multiple Claude Code agents involves using a supervisor to manage a fleet running in tmux windows. The system automatically discovers spare git worktrees, spawns agents into them, and maintains a centralized JSON state file to track progress.

Tmux provides the windowing environment where each Claude Code agent runs individually. The orchestration framework spawns agents into separate tmux windows, monitors their health, restarts idle agents, and handles safe confirmation approvals automatically.

The orchestration framework auto-discovers spare git worktrees and assigns individual tasks to each agent. When tasks are completed and verified via integration tests, the system automatically recycles those worktrees for future use.

Yes, agent orchestration requires several dependencies including tmux, git, jq, python3, gh, curl, perl, sed, and uuidgen. These tools support state management, git operations, API interactions, and terminal multiplexing.

Yes, orchestration integrates with PR workflows by addressing, testing, and evaluating pull requests in a controlled, serialized manner. The supervisor verifies task completion via checkpoints and tests before recycling worktrees.

Using tmux for orchestration requires all dependencies to be correctly installed and configured. The system relies on serialized PR workflows and centralized JSON state files, meaning network failures or missing dependencies can disrupt agent monitoring and worktree recycling.