From 45f2ee5d8b16879ee535c0799d3b11de785015dd Mon Sep 17 00:00:00 2001 From: Wes Etheredge Date: Wed, 22 Apr 2026 14:36:08 -0500 Subject: [PATCH] Update README.md --- README.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 572233e..2ee7588 100644 --- a/README.md +++ b/README.md @@ -4,26 +4,29 @@ ## Why postcard -AI agent sessions don't talk to each other. If you're running Claude Code -on three tiers of a web app — one on the frontend, one on the backend, -one on the Postgres schema — and your frontend agent needs the exact -shape of a backend response, your options are: copy-paste between +AI agent sessions don't talk to each other. If you're running sperate Claude Code sesisons +on three tiers of a web app: +- one on the frontend +- one on the backend +- one on the Postgres schema + +... and your frontend agent needs the exact shape of a backend response, your options are: copy-paste between windows, keep all three contexts in your own head, or stand up a message broker. -postcard picks a different option: treat each session as an addressable +Postcard picks a different option: treat each session as an addressable node on the local filesystem. No daemon, no network, no central service. A send is a git commit; an inbox is a directory. Every agent gets a random three-word address on startup and is discoverable via -`oat-postcard directory`. Messages are one-way postcards — title ≤140 -chars, body ≤1400 — fire-and-forget with an immutable audit trail. +`oat-postcard directory`. Messages are one-way postcards (title ≤140 +chars, body ≤1400) with a fire-and-forget with an immutable audit trail. When mail arrives, a subagent called the Clerk triages it on the recipient's next turn: routine items get filed into TODO, urgent ones get surfaced into the main agent's context. Nothing blocks, nothing polls, nothing phones home. -It's the smallest coordination primitive that works for agents sharing a +It's the *smallest coordination primitive* that works for agents sharing a filesystem but not a process. ## Install