Stats
Links
Categories
npx claudepluginhub gudnuf/mercuryMercury inter-agent message bus channel for Claude Code -- push notifications for multi-agent coordination.
Inter-agent message bus for multi-agent AI systems. Mercury moves text between named agents over a shared SQLite database -- no daemon, no config files, no network.
# Build from source (requires Nix)
nix build github:gudnuf/mercury
# Or: nix profile install github:gudnuf/mercury
# Send a message
mercury send --as oracle --to status "system online"
# Subscribe and read
mercury subscribe --as worker:auth --channel status
mercury read --as worker:auth
# => [status] oracle: system online
# Follow mode (polls for new messages)
mercury read --as worker:auth --follow
Mercury is a CLI tool that reads and writes to a single SQLite file at ~/.local/share/mercury/mercury.db. There is no server process -- every invocation opens the database directly. WAL mode enables concurrent access from multiple agents.
Agent A Agent B Agent C
| | |
| mercury send | mercury send | mercury read
| | | | | |
v v v v v v
+--------------------------------------------------------------------+
| mercury.db (SQLite + WAL) |
| messages | subscriptions | cursors |
+--------------------------------------------------------------------+
Key concepts:
oracle, keeper:studio, worker:auth). Mercury does not validate or enforce naming.status, workers, studio).mercury read --follow polls the database at 500ms intervals. There are no push notifications at the CLI level.Send a message to a channel.
mercury send --as <name> --to <channel> <body>
# Body can also come from stdin
echo "deployment complete" | mercury send --as deploy-bot --to status
Read unread messages from subscribed channels.
mercury read --as <name> # all subscribed channels
mercury read --as <name> --channel status # specific channel
mercury read --as <name> --follow # poll for new messages
mercury read --as <name> --verbose # include timestamps
Manage channel subscriptions.
mercury subscribe --as <name> --channel <channel>
mercury unsubscribe --as <name> --channel <channel>
List all channels that have messages.
mercury channels
Show message history (most recent first, reversed to display oldest-first).
mercury log # last 50 messages, all channels
mercury log --channel status # filter by channel
mercury log --limit 100 # more history
Mercury uses 3 core tables: messages, subscriptions, and cursors. A 4th table (routes) is being added for transport routing.
See docs/SCHEMA.md for the complete schema reference, including column definitions, relationships, and guidance for building new consumers.
Mercury's SQLite database is designed to be read by multiple consumers:
| Consumer | Language | Access | Description |
|---|---|---|---|
mercury CLI | Go | read/write | Source of truth. Creates the DB and schema on first run. |
| MCP server plugin | TypeScript/Bun | read/write | Bridges Mercury into Claude Code as push notifications. Polls for new messages and delivers them via MCP's notifications/claude/channel. Lives in plugin/. |
| Discord feed | TypeScript/Bun | read-only | Mirrors Mercury messages to a Discord channel as formatted embeds. Maintains its own cursor in a file. Lives at tools/discord-feed/. |
All consumers validate the database schema on startup and fail with a clear error if expected columns are missing.
# Nix (recommended)
nix build # produces result/bin/mercury
nix develop # dev shell with Go + gopls + sqlite
# Plain Go
go build ./cmd/mercury
go test ./...