Skip to content

postbag v1.1.0

Choose a tag to compare

@github-actions github-actions released this 09 Sep 05:49
· 104 commits to main since this release
cc0fed2

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: join records 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. claude and codex are reserved
    for doors of that vendor. The last join wins both ways, and join says
    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 to read, and, when the last door to hold it now
    holds another name, says which.
  • Letters are numbered within their exchange. Each open starts the next
    exchange and closes the one before it.
  • read begins 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, SendMessage and a
    session's name, onto postbag's.

Changed

  • join takes 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 --help and read --help describe 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 @claude and @codex.
  • A 1.0 session cannot answer a 1.1 letter, since its send takes only
    claude or codex. Upgrade both sessions, then ask each to join again.
  • A third door in the bag is experimental. read says so, the budget is
    shared, and nothing more is promised.