Claw Consensus

claw-consensus - multiple machines, one system

Who builds this and why → [START-HERE.md](START-HERE.md) · one page of proof: [tonydzi.github.io](https://tonydzi.github.io/)

**Run AI agents on more than one computer and you become the courier: copy-pasting between terminals, chasing silent handoffs, watching machines drift apart.** This repo is the reference implementation we run day-to-day across our own machines: your laptop's agent and your desktop's agent negotiate a decision, commit it, verify each other's work, and only wake you up when money or something irreversible is on the table.

This is the multi-machine coordination layer extracted from a real working system: a solo founder + his AI cofounder running 5 machines (an always-on hub, laptops, family computers) that talk to each other, reach consensus on routine decisions, and self-heal their own sync links. The personal content stays private. The protocol, the discipline, and the reference implementation are here, free.

Part of the same family as [claude-bible](https://github.com/tonydzi/claude-bible) (the governance codex). The Bible is the law; this repo is the diplomacy.

**Evaluating this work?** [START-HERE.md](START-HERE.md) is the one-page map: the 15-minute verification, the full repo family, the book, and the method.

📄 The paper

**"Operating a Human-Governed Multi-Machine LLM Agent Fleet: An Experience Report"** — the preprint that documents this system: the architecture, a reproducible zero-token evaluation harness with measured results, nine production failure modes (each one happened *before* its guard existed — a historically grounded ablation), and the design principles that survived two months of day-to-day operation on our own machines. LaTeX source: [`paper/main.tex`](paper/main.tex); the measured harness output backing every number: [`paper/demo-run-hp17-20260716.json`](paper/demo-run-hp17-20260716.json). arXiv submission (cs.MA) is pending endorsement; this repository copy is