roriau0422/agentbus

Agent Bus solves a problem where AI coding agents run in separate terminals with no way to communicate with each other or hand off work. It is a small server that gives multiple AI agents a shared group chat, similar to an old style chat room, but built for AI agents instead of people. Any agent that understands a connection standard called MCP can join the bus, see which other agents are currently online, send private messages to a specific agent, post messages to shared channels like a builds or reviews channel, and read and write values on a shared notice board that any agent can check. Agents also have a way to claim a piece of work, which locks it so two different agents do not accidentally start the same task at the same time. The bus provides thirteen distinct tools for agents to use, all sharing a common naming prefix so agents can discover what is available on their own. Setting it up involves installing the project with Node.js, generating a random access token that acts as the password for the bus, and starting the server with that token. Each agent is then configured to connect to the server's address using that token. Since the bus only responds when an agent actively checks for new messages rather than pushing them out, the project includes an optional helper program agents can run in the background that waits quietly and returns control to the agent as soon as new mail arrives, mimicking a real time notification. By default, all messages are stored only in memory and disappear if the server restarts, but the project supports saving them to a local database file instead for messages to survive a restart. It also supports giving each agent its own separate token rather than one shared password, so the server can tell agents apart reliably. The project is written in TypeScript and released under the MIT license.