Quilt: Run many AI coding agents in one Git checkout

Notifications You must be signed in to change notification settings

Fork 0

Star 1

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

227 Commits

227 Commits

.github

.github

bench

bench

design

design

docs

docs

examples

examples

src

src

test

test

.dockerignore

.dockerignore

.gitignore

.gitignore

CHANGELOG.md

CHANGELOG.md

CONTRIBUTING.md

CONTRIBUTING.md

Dockerfile

Dockerfile

LICENSE

LICENSE

README.md

README.md

SECURITY.md

SECURITY.md

glama.json

glama.json

package-lock.json

package-lock.json

package.json

package.json

server.json

server.json

tsconfig.json

tsconfig.json

Repository files navigation

Quilt is a command-line tool that tracks which agent wrote which lines in a shared Git checkout, so multiple AI coding agents can work in one repo at once and each commits only its own changes.

It captures every edit at the tool boundary, keeps a per-line record of who wrote what, and reconstructs each agent's own changes at commit time. Git stays the source of truth. Quilt never calls an LLM or spawns agents, and its state lives in a .quilt/ sidecar you can delete without touching your repo.

npm install -g @quilt-dev/cli quilt setup # wire Quilt into your repo (Claude Code, Cursor, or plain git)

The problem

You want your agents in ONE checkout: one node_modules, one build, one dev server, one environment to keep working, not a worktree per agent, each with its own install and its own drift. But on a shared checkout, plain git bites even when agents work on completely different things: the first git commit -am sweeps everyone else's uncommitted files into one blob, codegen and lockfile churn get credited to whoever committed last, and two agents occasionally do land on the same line, where one silently overwrites the other. None of that requires agents to be working on the same task. It's just what a shared checkout does by default.

Quilt makes the shared checkout safe. Every agent commits exactly its own lines and nothing else: disjoint work stays disjoint all the way into history, with no ceremony. And when two agents genuinely want the same code, that becomes a coordinated handoff instead of a silent loss. It holds as you add agents.

./examples/fleet.sh runs seven agents against one checkout. The two endings:

WITHOUT quilt 1 commit for 7 agents — six got "nothing to commit", their work swept into the first agent's blob. a7 silently overwrote a1's change to getUser. a1's work is gone.

WITH quilt 6 clean commits, one per agent, each exactly its own lines. a7's write into a1's claimed function was denied before any bytes changed, with a1's stated intent in the denial.

When two agents want the same file

Fanning out on disjoint files is the easy case. The real test is contention. A denied claim isn't a dead end. It carries the holder's stated intent and when their lease lapses:

$ QUILT_ACTOR=builder-flows quilt claim deals.js flows.js --intent "wire flows to deals" ✗ denied deals.js (held by builder-friction) builder-friction is: friction pass: rename + archive flags their claim lapses 2026-07-04T22:12:05Z unless renewed ✓ claimed flows.js

So the blocked agent builds its granted files while it waits, re-claims after the holder's commit auto-releases, and layers its change on top of the landed one. Two clean commits, both changes in the file, nothing lost. ./examples/contention.sh runs the whole sequence on the real machinery.

What it does

One shared checkout. Model humans, agents, and bots as actors editing one working tree, no worktree per agent.

Line-level attribution. commit --mine commits only your lines, even when they share a hunk with another actor's.

Symbol-level claims. Reserve utils.js#formatPrice, not the whole file, so agents editing different functions never contend. Ten languages via tree-sitter; whole-file claims for the rest.

Collision prevention. A write into code another agent has claimed is denied, with the holder's stated intent, before any bytes change.

Push-awareness. Claim a symbol that depends on a function another actor is changing, and Quilt warns you at claim time.

Detect and preserve. If one actor overwrites another's uncommitted lines, Quilt snapshots the victim's version so nothing is silently lost.

Every commit Quilt produces is an ordinary Git commit. It trusts Git and never rewrites it, and all state lives locally under .quilt/. No account, no daemon.

Quickstart

quilt setup # wire Quilt into the repo (MCP server, hooks, coordination) quilt doctor # confirm it's wired and capture is flowing

That's it. Agents are named automatically: each Claude Code session or MCP connection gets its own id, so parallel agents are told apart with no setup. Set an explicit id when you want one that is stable across sessions:

QUILT_ACTOR=auth-agent claude # this agent's edits are attributed to auth-agent

Then each agent commits only its own lines:

quilt status # who owns what quilt preview --mine # exact patch that would be committed quilt commit --mine -m "fix auth redirect"

quilt fleet shows the whole picture: every actor, their claims, and anything that needs a human. See docs/reference.md for the full command list.

Why not worktrees?

A worktree per agent is the usual answer, and for fully independent tasks it works. But every worktree is another environment to build (another install, another build cache, another dev server) and isolation just moves the collision to merge time. Those costs grow with the number of agents; the whole point of a shared checkout is paying for the environment once.

Run fewer agents Worktree per agent Quilt

Parallelism capped low high high

Setup per agent none full install/build/env × N none (one checkout)

See each other's in-flight work n/a no yes

Collisions avoided by hand surface at merge prevented, or surfaced live

Clean per-agent commits n/a after a merge yes

Worktrees isolate; they don't coordinate. When agents work the same code at the same time, you usually want them to see each other and account for each other as they go. That is what Quilt does. The two aren't mutually exclusive: worktrees for independent, long-running work, Quilt for agents in the same code at once.

Using it with agents

quilt setup wires the capture hooks and a shared MCP server. On Claude Code the hooks let agents use the built-in Edit and Write tools normally while Quilt records each change's author and blocks a write into code another agent holds, with no protocol for the agent to follow and no setup: each session is named automatically, or carries its own QUILT_ACTOR for a stable id. For other runtimes, the same capture and prevention is available as MCP tools, with each connection named automatically the same way.

See docs/orchestrators.md for Codex, Cursor, Aider, and the difference between process-per-agent and many-agents-in-one-process setups.

Docs

docs/orchestrators.md: running a fleet of agents.

docs/reference.md: the full command list, how attribution works, and the .quilt/ state layout.

bench/: the scenario ladder Quilt is tested against, run with and without Quilt on the same metrics.

Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT

About

Tracks which agent wrote which lines when multiple AI agents share one Git checkout.

www.npmjs.com/package/@quilt-dev/cli

Topics

git

cli

mcp

multi-agent

developer-tools

ai-agents

llm

agentic

coding-agents

claude-code

Resources

Readme

License

MIT license

Contributing

Contributing

Security policy

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks

Report repository

Releases 8

v0.4.3: async claims, and the queue plays fair

Latest

Jul 6, 2026

+ 7 releases

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

TypeScript 87.3%

JavaScript 12.5%

Dockerfile 0.2%