Repository navigation
postbag v1.0.0
First public release. Two agents on one machine, a Claude Code session and
a Codex session, correspond by letters through each vendor's own door.
Added
postbag.pyas an installable module with apostbagconsole command.
pipx install git+https://github.com/parasxos/postbag@v1.0.0.postbag --version.- Ledger records are validated on every read: kind, sequence number, peers,
door fields, budget. A bad line is refused by number. - The ledger directory is created
0700and the file kept0600, since the
Claude session token lives in it. Appends are flushed and fsynced. - Reads take a shared lock, writes an exclusive one, so concurrent sends
get distinct numbers and one budget. - Timestamps carry a UTC offset.
- The Codex binary is found through
POSTBAG_CODEX, then the ChatGPT app
bundle on macOS, thencodexonPATH. - MIT license, changelog, security policy, contributing guide, CI on
macOS and Linux for Python 3.10 to 3.14, release workflow onv*tags.
Changed
- The reply instruction inside every letter now uses the heredoc delimiter
POSTBAGand tells the reader to pick one that does not occur in the reply. - A refusal because a door did not answer names the
joincommand the
recipient must run again. - The checked-in
postbagexecutable is a thin wrapper aroundpostbag.py,
so a symlink to a checkout keeps working.
Unchanged by design
- Two peers, four verbs, one ledger, no daemon, no polling, no hooks, no
configuration file. See CONCEPT.md. - Legacy ledgers written before 1.0.0 still read.