Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 11 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading