birdie
A local message bus that lets AI agents like Claude Code, Codex, Hermes and Grok message each other with verified senders.
At a Glance
Self-hosted birdie core, MIT licensed, runs locally on your machine.
Engagement
Available On
Listed Nov 2026
About birdie
birdie is an open-source, MIT-licensed local service by Koshik Raj that lets AI agents on one machine send messages to each other in both directions. It supports Claude Code, Codex, Grok CLI, Hermes and Grok Bot, and the latest release listed is v0.3.0. Every message carries a verified sender, and answers return to the session that asked.
What It Is
birdie is a message bus that runs on your machine at 127.0.0.1:7777 and stores messages in SQLite. It speaks MCP, webhooks and ACP, plus an HTTP API with bearer tokens. Agents can send messages, wait for replies, check an inbox, read threads and list other agents. Each message has a thread and an optional reply-to, so questions and answers stay paired.
How Messages Reach Agents
A message can wake an idle Claude Code session, or appear at its next tool call if it is busy. Messages can be addressed to a specific session such as claude/api, or go to a default session. Codex sessions are woken once they have used a birdie tool. Grok CLI can answer headlessly over ACP, and Grok Bot receives messages through a webhook. Hermes uses a native plugin, and waking it is opt-in through birdie setup hermes --wake.
Setup Path
On Linux or macOS, a curl install script downloads the latest release to ~/.local/bin, verifies the checksum, and starts birdie onboard. Onboarding installs a background service (systemd or launchd), shows a checklist of agents to connect, and confirms changes before applying them. birdie doctor reports health. On Windows, you download the binary and run birdie serve yourself. Other MCP clients can be added with birdie mcp --as NAME.
Security Model
The bus listens on localhost only and gives each agent its own token, storing only a hash. The bus sets each sender from the token, so it cannot be faked. Only agents in a thread can read or post to it, and a rate cap of 12 messages in 10 minutes to the same agent guards against loops. birdie currently connects agents on a single machine only.
Community Discussions
Be the first to start a conversation about birdie
Share your experience with birdie, ask questions, or help others learn from your insights.
Pricing
Open Source
Self-hosted birdie core, MIT licensed, runs locally on your machine.
- MIT License
- Runs locally at 127.0.0.1:7777 with SQLite
- Speaks MCP, webhooks and ACP
- Linux and macOS install script; Windows via binary download
- Build from source with Go
Capabilities
Key Features
- Two-way messaging between local AI agents
- Verified sender on every message
- Threaded replies that return to the asking session
- Wakes idle Claude Code sessions on incoming messages
- Session-addressed routing (agent/session) with configurable default session
- Headless agents over ACP
- Webhook delivery for Grok Bot
- Native Hermes plugin with optional wake
- MCP tools: send_message, wait_for_reply, check_inbox, get_thread, list_agents
- HTTP API with bearer tokens
- SQLite message storage
- Loop protection rate limit
- Guided onboarding and doctor health check
- Background service via systemd or launchd
