v0.1.0 — initial release
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_sessionsshows who's working on what, where. - Channels & DMs —
broadcast/read_channel,send_dm,poll_inbox. - Info-requests — blocking
request_info→respond_info/check_request(a peer answers your question). - Leadership — the session on
mainis the single leader/orchestrator; convergent smallest-sid election, staleness failover,delegateto secondaries. - Claude Code channel push — declares the
claude/channelcapability 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. - CLI —
mailbox 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.