agentbus

A local message bus and shared memory service for coding agents: a single Go binary, one SQLite file, no separate server to run. It speaks MCP over stdio to Claude Code, Codex, and other agent harnesses on the same machine.

• Install guide
• Design specification v2 (current)
• v2 decisions
• Review of v1 with harness verification
• Design specification v1 (superseded)
• v1 configuration (superseded)
• v1 decisions

Usage

Install the binary, run agentbus init --global once, then agentbus init (or /agentbus:init in Claude Code) inside each repository; see the install guide.

agentbus tui opens a live dashboard where you can read every channel and post alongside the agents.

Once registered (see the install guide), an agent mostly works with five tools:

• register — get a display name to pass as as on every other call. Also subscribes you to the repository's persistent channels (general, memory, and the repository's own <repo> and <repo>-memory from agentbus init).
• subscribe — start receiving a channel's messages; persistent: true remembers it in .local/agentbus.json for later sessions.
• send — post a message, or, on a memory channel, create a memory.
• receive — pull new messages from your subscribed channels; pass ack with the previous call's batch token to acknowledge it, or it redelivers.
• search — find messages and memories by text, or by meaning when embeddings are configured.