Lokale Merge Queue fuer parallele Claude Code Agents

Claude Code ist praktisch - bis du mehrere Agents parallel auf dasselbe Repo loslaesst. Dann gibt es Push-Races, redundante Builds und flaky Tests. GitHub’s eigene Merge Queue hilft, braucht aber Enterprise Cloud, Pull Requests und kostet Actions-Minuten. Jesse Heaslip hat mit claude-code-merge-queue eine lokale, kostenlose Alternative gebaut.

Wie es funktioniert

Das Tool nutzt git worktrees, um jedem Agent eine isolierte “Lane” zu geben - lane/1, lane/2, usw. Jede Lane bekommt ein eigenes Working Directory und einen eindeutigen Dev-Server-Port. Eine FIFO-Queue serialisiert alle Landings: Agents rufen land auf, was ihren Lane auf main rebased und durch die Queue pusht. Nie pushen zwei Lanes gleichzeitig.

Dazu gibt’s einen machine-wide Build Lock: build-lock -- <cmd> fuehrt Build-Kommandos serialisiert ueber alle Lanes aus. Keine parallelen Heavy Builds mehr, die den Rechner in die Knie zwingen.

Key Features

• init - Projekt einrichten, generiert claude-code-merge-queue.config.mjs
• land - Rebase + Push durch die FIFO-Queue
• sync - Fast-forward main, reinstall deps bei geaenderter Lockfile
• promote - Integration -> Production (human-only, nie automatisiert)
• preview - Spiegelt uncommitted Changes auf main Checkout fuer instant Review
• build-lock - Serialisiert Builds machine-wide
• Integriert sich in Claude Code’s nativen WorktreeCreate Hook

Unterschied zu GitHub Merge Queue

Kein PR noetig, keine Actions-Minuten, funktioniert auf jedem GitHub-Plan. Direkter Rebase + Push statt Pull Request Workflow. Zwei-Stage Model (Integration -> Production) optional konfigurierbar. MIT-lizenziert, TypeScript, npm-Package.

Installierbar via npm install --save-dev claude-code-merge-queue und npx claude-code-merge-queue init. Aktuell v0.5.8.

github.com/funador/claude-code-merge-queue