Repository navigation
postbag v1.1.0
Any two sessions, of the same vendor or not. The nouns and verbs are the
same five and four, and the words now match Claude Code's own.
Added
- Named doors:
joinrecords the session's door under a name, by default
the vendor. A name is a lowercase letter followed by up to fifteen
lowercase letters, digits or hyphens.claudeandcodexare reserved
for doors of that vendor. The lastjoinwins both ways, andjoinsays
what it renamed or took. - Any two sessions can correspond, two Claude Code sessions included. The
sender is the door the shell runs in, matched against exactly one
registered name. There is still no--from. send @name, with or without the@. A send to a name nobody holds
refuses and points toread, and, when the last door to hold it now
holds another name, says which.- Letters are numbered within their exchange. Each
openstarts the next
exchange and closes the one before it. readbegins with one line: the names the bag holds now, each with its
vendor, and the open exchange. Records are grouped by exchange, and joins
carry a note when they renamed a door or took a name.- The envelope names the exchange, "Letter 4 of 12 from @ada to @bob via
postbag (exchange 3)", says the budget is shared by everyone in the bag,
and lists the registered names when the bag holds more than two. - CONCEPT.md gains a table mapping Claude Code's words,
SendMessageand a
session's name, onto postbag's.
Changed
jointakes a vendor and an optional name:postbag join claude ada.- The reply command inside a non-final letter is
postbag send @name -.
The last letter of an exchange carries none and says not to reply. - CLI output and refusals never carry door credentials, and only
ledger-integrity refusals name a ledger line. - Argument errors end the same way every refusal does: stop and ask the
human. A truncated ledger's refusal names the last complete line and asks
you to inspect the last record before repairing the file. open --helpandread --helpdescribe their arguments, and the default
budget of 12 letters is stated.
Compatibility
- Ledgers written by 1.0 read without rewriting. Legacy vendor peers read
as@claudeand@codex. - A 1.0 session cannot answer a 1.1 letter, since its
sendtakes only
claudeorcodex. Upgrade both sessions, then ask each tojoinagain. - A third door in the bag is experimental.
readsays so, the budget is
shared, and nothing more is promised.