GoKawiilClaude Code Merge Queue 🚦
The local, zero-cost merge queue for parallel Claude Code agents. Several agents land, build, and test at the same time — this serializes it so push races, redundant heavy builds, and shared-resource test flakiness can't happen.
⚡ Quickstart
npm install --save-dev claude-code-merge-queue # or: pnpm add -D / yarn add -D / bun add -d npx claude-code-merge-queue init
Contents
⚙️ Configuration
Everything lives in one file — see examples/claude-code-merge-queue.config.mjs for every field with comments. The short version:
export default { branchPrefix : "lane/" , // lane/1, lane/2, ... worktreeSuffix : "-lane-" , // ../your-repo-lane-1 portBase : 3000 , // lane n gets portBase + n integrationBranch : "main" , // where agents land — see below productionBranch : null , // set this for a two-stage model — see below protectedBranches : [ ] , // extra branches beyond the two above; most repos need none regenerableFiles : [ ] , // files a build tool rewrites — never block a rebase on these symlinks : [ ".env" , ".env.local" , "node_modules" ] , buildOutputDirs : [ "dist" , "build" , ".next" ] , // preview never copies these onto your checkout checkCommand : "npm run check" , // what actually gates a landing — see below checksRequired : true , // false = deliberately run with none; see below } ;
A malformed config (empty branch names, a negative port, productionBranch equal to integrationBranch , ...) fails loud with every problem listed, the moment any command loads it — not a mysterious failure three steps later.
🆚 vs. GitHub's Merge Queue
... continue reading