{"slug": "show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree", "title": "Show HN: A file-based protocol for two AI agents to talk until they agree", "summary": "A new open-source protocol called agent-talk enables two AI agents to collaborate on a single markdown file until they reach consensus, requiring no server or framework. The protocol, developed by Reindent and available on GitHub under an MIT license, works with Claude Code, Codex, Grok, and any agent that can edit files, and is already running in production for real handoffs. The file serves as the conversation, with agents taking turns editing the document until one proposes consensus and the other confirms it, with a configurable timeout to prevent endless loops.", "body_md": "One shared markdown file. Two agents taking turns. **No server, no framework.** They edit the same document until they reach consensus.\n\n**Works with** Claude Code, Codex, Grok, and any agent that can edit a file\n\nYou start a session, hand the ID to a second agent, and they converge on one document. The file is the conversation.\n\nIt states the task and its position in a new session file, then hands you a short `session ID`\n\n.\n\nGive the ID to any second agent. It registers itself in the same file and takes its turn. Different CLI, different model, same document.\n\nTurns alternate. One side proposes consensus, the other confirms it. A timeout ends sessions that will not converge.\n\nThe whole protocol is a file format and four rules. There is nothing to install on a server, and nothing to keep running.\n\n```\n# agent-talk <sessionID>\nTASK: one line describing the job\nAGENTS: <id>=initiator, <id>=joiner\n---\nThe shared working document.\nBoth agents restructure it freely,\nturn by turn, toward the answer.\n\nEND OF <id-of-who-just-finished>\n```\n\n**One file.** The session is a single markdown document on disk. Reading it is reading the whole state.\n\n**One writer at a time.** You may edit only when the last END OF line names the other agent.\n\n**One atomic write per turn.** Compose fully, write once. No partial edits, no races.\n\n**No chat log.** Agents modify the document instead of appending messages. It converges into the final answer.\n\nChat logs grow. This file converges. When the session ends you do not scroll a transcript, you read the answer.\n\nEach turn refines one living document. The last version is the result, with the agreement written into it.\n\nAny agent that can read and write files can participate. Two Claudes, Claude with Codex, Grok with anything.\n\nConsensus is explicit: one agent proposes it, the other confirms it. A configurable timeout stops endless loops.\n\nSpin up a second agent with full context and let the two split the work between them.\n\nOne session owns the content, the other owns the build. The file is the contract between them.\n\nTwo different models argue a decision until one position survives. You read the consensus, not the debate.\n\nFirst used to settle a real disagreement between **Codex** and **Claude** about a branch. Today it runs real production handoffs. The demo above is a real session: the two agents planning this very website.\n\nThree skills in one install: the protocol, the monitor, and the timeout config. MIT licensed. The protocol you just watched is running in production.\n\nThen: `/agent-talk \"your task\"`\n\nin one agent, hand the session ID to the other. Source on [GitHub](https://github.com/reindent/agent-talk). Follow [@daraosn](https://x.com/daraosn) on X.", "url": "https://wpnews.pro/news/show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree", "canonical_source": "https://agent-talk.reindent.com/", "published_at": "2026-08-05 06:00:28+00:00", "updated_at": "2026-08-05 06:22:59.874271+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools"], "entities": ["Reindent", "Claude Code", "Codex", "Grok", "GitHub"], "alternates": {"html": "https://wpnews.pro/news/show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree", "markdown": "https://wpnews.pro/news/show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree.md", "text": "https://wpnews.pro/news/show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree.txt", "jsonld": "https://wpnews.pro/news/show-hn-a-file-based-protocol-for-two-ai-agents-to-talk-until-they-agree.jsonld"}}