bridgey
Facilitate inter-agent communication for Claude Code using the A2A protocol.
bridgey
Inter-agent communication for Claude Code via the A2A protocol. Each Claude Code instance becomes both an A2A client and server, forming a mesh network for multi-agent collaboration.
What it does
- Agent-to-agent messaging -- Send messages between Claude Code instances over HTTP using Google's A2A protocol
- Tailscale mesh discovery -- Auto-discover bridgey agents on your Tailscale network
- Transport adapters -- Bridge external platforms (Discord, etc.) into the agent mesh
- Channel integration -- Push inbound messages to Claude Code sessions via the Channels API
Architecture
Claude Code <-stdio-> Channel Server <-HTTP-> Daemon <-A2A/HTTP-> Remote Daemons
|
Transport Adapters (Discord, etc.)
Two processes per instance:
- Daemon (Fastify HTTP) -- long-running A2A server, persists across CC sessions
- Channel Server (stdio MCP) -- pushes messages to CC, lives with the session
Plugins
| Plugin | Purpose |
|---|---|
bridgey | Core daemon + MCP server + Tailscale discovery |
bridgey-discord | Discord transport adapter |
bridgey-deploy | Remote deployment skills (Docker, Coolify, Tailscale SSH) |
Install
As a Claude Code plugin
# Install the core plugin (recommended)
claude plugin add ./plugins/bridgey
# Optional: Discord transport
claude plugin add ./plugins/bridgey-discord
# Optional: Deployment skills
claude plugin add ./plugins/bridgey-deploy
Development setup
git clone https://github.com/kickinrad/bridgey.git
cd bridgey
npm run install:all # Installs all plugin dependencies
npm run build # Bundles all plugins to dist/
npm test # Runs all tests
Quick start
- Run
/bridgey:setupin Claude Code to configure your instance - The daemon starts automatically via SessionStart hook
- Use
send,list_agents,get_inboxtools to communicate - Share your connection snippet (
/bridgey:status) with other instances
License
MIT