Repository navigation
postbag v1.3.0
MCP tools remove shell-command friction while retaining the existing bag,
native transports, and human-controlled letter budget. Upgrade both peers
to the same version, reconnect their MCP servers, and rejoin under the
same names. Existing ledgers and remaining budgets need no migration.
Added
- Optional
postbag[mcp]extra andpostbag-mcpstdio entry point with four
tools: join, send, read, and bag inventory. Budgets remain human-controlled.
Tools bind native caller identity, accept named bags, return structured
outcomes, and isolate each invocation in a subprocess. - MCP wire tests for current and legacy clients, sender binding, private
socket delivery, concurrency, budget limits, pagination, and cancellation. - Installed-package native acceptance with Claude Code 2.1.285 and Codex
0.157.1 / desktop 0.158.0-alpha.2.1, including default server discovery,
model-authored replies, observed receipt, and spent-budget refusal.
Live Claude/clear, native Linux delivery and restricted spawned-agent
targets remain unverified. Forced process-tree termination can leave an
unknown submission outcome. postbag bags --resumeshows Claude resume commands using optional conversation
IDs recorded atjoin. These snapshots do not change door identity or routing.
Older or invalid metadata gets one rejoin reminder after the inventory.
Known IDs add one copyable command per peer beneath the bag's ordinary row.postbag bags, a read-only inventory with a count of discovered paths, remaining budget,
last recorded letter timestamp, and registered names with vendors.- Scan the default ledger and valid named ledgers directly under
~/.postbag/bags, plus an explicitly selected existing custom path.
Unselected external paths cannot be discovered. A selected custom alias
of an already listed regular file is not repeated. - Unavailable ledgers remain in the count. Busy or unreadable ledgers and scan
errors do not hide other readable bags. The command reports them and exits 1.
It creates no files or index, probes no sessions, and changes no ledger format.
Budgets do not expire, and registered names do not imply live sessions. - Terminal inventory adapts to width, groups peers by vendor and orders bags
by their last recorded letter. It uses brief local times and optional styling.
Piped output keeps the original table, order and full ISO timestamps.
NO_COLORorTERM=dumbdisables terminal styling.
Changed
- Report uncertain native submissions without advice to blindly resend.
Timeouts, partial socket writes, and nonzero queue exits may have delivered.
Recording failures preserve the fact that native submission succeeded. - Keep
bags --resumein the ordinary compact inventory layout. Show missing-ID
guidance once and brighten secondary terminal text for readability. - Clarify that postbag records submission, does not read delivery notices,
and does not guarantee recipient acceptance. Claude's inbound policy may
hold or refuse a letter even in a bypass-permissions session. - Record runtime versions and recipient policy in native acceptance checks,
distinguishing live receipt from successful submission. - Verify the unchanged native transport between two headless Claude Code
2.1.278 sessions on macOS, with separate recipient-policy probes.
Fixed
- Prefer the concrete
CODEX_THREAD_IDover the shared root's
CODEX_SESSION_ID, keeping the latter as a fallback for older hosts.
Existing peers whose thread differs from that shared ID need to join again. - Refuse NUL-containing messages and oversized native command arguments with
actionable errors before submission. - Render stored timestamps in canonical form so legacy timestamp separators
cannot inject terminal controls.