This project addresses the challenge of coordinating multiple AI agents (Claude Code) to work autonomously on GitHub repositories. It targets developers and researchers seeking to parallelize codebase tasks, offering increased development throughput by embracing parallel, potentially redundant, agent work, with CI as the sole arbiter for progress.

How It Works

multiclaude orchestrates multiple Claude Code agents on GitHub repositories, adopting a "Brownian Ratchet" philosophy: chaos from parallel agent work is accepted, with Continuous Integration (CI) acting as the arbiter to ensure permanent forward progress. Agents operate within isolated tmux windows and git worktrees, communicating via filesystem messages. The system comprises a Supervisor for coordination, Workers for task execution and PR creation, and a Merge Queue for automated merging post-CI, optimizing for throughput of successful changes over individual agent efficiency.

Quick Start & Requirements

• Install: go install github.com/dlorenc/multiclaude/cmd/multiclaude@latest
• Prerequisites: tmux, git, authenticated gh (GitHub CLI).
• Run: multiclaude start (daemon), multiclaude init <github-url> (repo), multiclaude workspace add <name> (workspace), multiclaude work "task description" (worker).

Highlighted Details

• Employs an MMORPG-like collaboration model for remote-first development, where agents work autonomously even when the user is offline.
• Prioritizes "worse is better" simplicity, positioning itself as a lightweight alternative to more complex orchestrators like Gastown.
• Includes reusable Go libraries (pkg/tmux, pkg/claude) for programmatic tmux interaction and Claude Code execution.
• Agents are designed to strictly adhere to CI checks, asking for help or retrying rather than weakening quality gates.

Maintenance & Community

The project is described as being in "early development." No specific community links (Discord/Slack) or details on notable contributors are provided in the README.

Licensing & Compatibility

Licensed under MIT, which generally permits commercial use and closed-source linking without significant restrictions.

Limitations & Caveats

The project is explicitly stated to be in "early development," suggesting potential instability or missing features. Its minimalist approach may lack the sophisticated orchestration and crash recovery capabilities found in alternatives like Gastown. The system relies heavily on external tools: Go, tmux, and an authenticated GitHub CLI.