Weft coordinates coding agents while they edit—not only when they open a pull request. Agents submit tool-call edits to a per-repository sequencer. The sequencer validates each edit against accepted changes since the agent's base and returns actionable diagnostics to the agent through its native hooks. Humans see the same event stream and can approve, pause, message, undo, or inspect evidence.
The goal is to make concurrent agent work safer without file locks or requiring agents to stop and wait for a human merge. WCP is the harness-neutral wire protocol; Weft is its Cloudflare-backed implementation and set of adapters.
Live demo: demo.weft.mx — the web UI over the real event logs of the dogfood repo and the demo runs, public and read-only (no login).
Status: research/demo implementation; WCP v0.1 is a draft, not a published standard. See the design, protocol specification, and try it yourself.
Plain-language one-pagers: Protocol · Platform · Product.
flowchart LR
subgraph agents[Agent workspaces]
H[Claude Code / Codex / OpenCode / Hermes] --> A[Harness adapter + analyzer]
end
A -->|check / edit / events| G[Gateway]
G --> C[Repo coordinator\nDurable Object + SQLite\nordered WCP log]
C -->|verdicts / diagnostics / inbox| A
C --> Q[Queues]
Q --> W[Workflows\nprocess / select / land / revert]
W --> S[Sandbox containers\nmerge / tests / agent]
W --> R[Artifacts + evidence]
G --> D[D1 index]
HN[Human web / iOS clients] <-->|observe / human actions| G
Adapters translate harness hooks into WCP requests; the protocol and coordinator do not depend on any one coding agent. Artifacts hosts repos and candidate forks. A single Durable Object per repo assigns event order and validates edits. Workflows orchestrate revision processing, candidate selection, landing, and revert. Sandboxes perform git and test operations without exposing credentials to the agent container. D1 indexes tasks, changes, revisions, and evidence; R2 stores run artifacts. The live demo and preview environment are described in the runbook.
- Workers provide the gateway, UI, preview service, and product integrations close to the coordination API.
- Durable Objects with SQLite give each repository one authoritative ordered log, state machine, and submit queue.
- Artifacts supplies the trunk and isolated candidate forks.
- Queues and Workflows make push processing, tests, selection, landing, and recovery durable and retryable.
- Containers / Sandbox SDK isolate git, builds, tests, and optional agent runs; credentials are mediated outside the container.
- D1 indexes cross-repo tasks and evidence; R2 retains logs, transcripts, and screenshots.
- Workers AI, AI Gateway, and Browser Rendering support risk/review assistance, attributable model traffic, and visual evidence. They are supporting services, not required to understand the core WCP event model.
The implementation is evolving; the design distinguishes core, strong, and optional product integrations. No production deployment is implied by this repository.
In any git repository, with Node.js 22+:
npx @celador/weftNo login and no account: it creates a free hosted space on Weft's Cloudflare gateway, adds
Weft's hooks for the coding agents you have (Claude Code, Codex, Cursor, Copilot CLI, OpenCode,
Gemini, Antigravity) to every checkout, offers a second worktree so two agents can work side by side, and opens your
private live feed. Agents with MCP but no hooks (Zed, Warp, JetBrains, Xcode) use
npx @celador/weft mcp. --local runs the gateway on your machine instead; deploy puts it in your
own Cloudflare account. The npm package is @celador/weft
(the name weft is taken on npm). No repo handy? npx @celador/weft demo makes a two-file
sample repo and prints the two prompts that make your agents collide. Details:
docs/try-it.md and docs/hosted.md.
Install it where you already work:
| Where | Install |
|---|---|
| Claude Code (plugin) | /plugin install weft --marketplace celador/weft, then /weft:setup in your repo |
| GitHub Copilot CLI (plugin) | copilot plugin marketplace add celador/weft and copilot plugin install weft@weft |
| VS Code, Cursor, Windsurf, Kiro, Antigravity, VSCodium | the .vsix from the VS Code release: code --install-extension weft-0.1.1.vsix (Marketplace and Open VSX listings to follow) |
| Any MCP client without hooks (Zed, Warp, JetBrains, Xcode, ...) | {"command": "npx", "args": ["-y", "@celador/weft", "mcp"]}, started in the checkout |
Status of each listing: docs/research/distribution-2026-10.md.
From a clone, without any network service (docs/try-it.md, Advanced):
pnpm install --frozen-lockfile
cd apps/gateway && echo "WEFT_ADMIN_TOKEN=$(openssl rand -hex 16)" > .dev.vars.test && pnpm dev:local # terminal 1
node scripts/local-quickstart.mjs --demo # terminal 2, repo rootTo wire Weft into an agent setup you already run (any harness), read docs/integrate.md.
Every coding-agent runtime has hooks; none are interoperable. We propose the hook semantics Weft runs on as a small open standard, separate from Weft itself:
- One-pager (PDF): problem, proposal, evidence, ask.
- Agent Hooks Core v0.1: capability levels L0–L3, normalized lifecycle events, the allow/advise/deny decision envelope, diagnostics, failure policy, host mappings. WCP is its coordination extension.
- Conformance suite (
wcp-hook-conformance): runs any hook command through the core fixtures and reports the level it verifies. See the reports for the Weft adapters. - 3-minute video for meetings.
Discussions are open: github.com/celador/weft/discussions.
packages/protocol— WCP types, schema, validator, reference coordinator, and conformance fixtures.packages/conformance— standalone hook conformance runner for Agent Hooks Core (wcp-hook-conformance).packages/analyzer— TypeScript diff-to-symbol read/write analysis.packages/adapters— harness-specific hook translators.apps/gateway,apps/workflows,apps/sandbox,apps/web— coordination API, durable jobs, isolated execution, and human UI.demo/— scenarios, drivers, and recorded evidence.scripts/local-quickstart.mjs— local gateway setup: repo, tokens, adapter installs,--demo,land.docs/— design, protocol, runbooks, and AAIF proposal.
MIT; see LICENSE.