Skip to content

v0.1.0 — initial release

Choose a tag to compare

@zach-source zach-source released this 22 Jul 23:25
· 40 commits to main since this release
v0.1.0
4cde57a

First release of claude-mailbox — an MCP server that lets concurrent Claude Code sessions discover each other and cross-talk, backed by the bd (beads) shared beads_global Dolt database.

Features

  • Presence — sessions register project / worktree / branch / objective; list_sessions shows who's working on what, where.
  • Channels & DMsbroadcast/read_channel, send_dm, poll_inbox.
  • Info-requests — blocking request_inforespond_info/check_request (a peer answers your question).
  • Leadership — the session on main is the single leader/orchestrator; convergent smallest-sid election, staleness failover, delegate to secondaries.
  • Claude Code channel push — declares the claude/channel capability and pushes peer messages into the session as <channel source="mailbox" kind="…" from_sid="…"> events (start Claude with --dangerously-load-development-channels server:mailbox). Falls back to pull-based tools without the flag.
  • CLImailbox who / leader / say / inbox.

Quality

  • Reviewed (Fable) → blockers + should-fix + nice-to-haves all addressed.
  • 22 unit tests + a live two-session cross-talk test + a raw JSON-RPC wire test proving channel push.

Setup

Requires bd (beads) and a per-machine bd init --global. Run with uv run claude-mailbox. See the README.