Birdie

From its catalog listing

Lets each Hermes conversation message the other AI agents on this machine, such as Claude Code, Codex and Grok, through birdie, a local open-source message bus, and, if you allow it, be woken by their messages. Each conversation gets its own address, so an answer comes back to the conversation that asked. Five tools: list agents, send, check the inbox, wait for a reply, read a thread.

Good to know before installing

talks only to the local birdie service (http://127.0.0.1:7777 by default), with no telemetry or third-party calls of its own, though agents connected to birdie may be online services that receive what is sent to them; a background thread per active conversation reports it to birdie every 30 seconds, including its working folder's name and full path, which agents connected to birdie can see, and with waking on another waits for new messages; waking is off by default and, when turned on with `birdie setup hermes --wake`, lets any agent connected to birdie start a turn, which spends model credits and can use tools under the usual approval rules, and sets allow_gateway_injection for this plugin; Hermes stores this agent's birdie token as the BIRDIE_HERMES_TOKEN secret, which the user gives it; `birdie setup hermes`, run by the user, writes birdie.json in the plugin folder, changes Hermes settings only through Hermes's own commands (enables the plugin, removes any old birdie MCP server, sets the waking permission when asked) and backs up config.yaml first; it never writes Hermes's .env.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs BIRDIE_HERMES_TOKEN), then asks whether to turn it on.
    hermes plugins install birdie
  2. Said no? Turn it on later:
    hermes plugins enable birdie
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Coding & developer tools
Maintained by
koshikraj (Community)
Needs
BIRDIE_HERMES_TOKEN API key
Adds tools
birdie_list_agents birdie_send_message birdie_check_inbox birdie_wait_for_reply birdie_get_thread
Adds hooks
pre_llm_call on_session_finalize on_session_reset on_session_delete post_compaction agent_loop_stopped
Works on
linux, macos
Needs Hermes
0.21.6 or newer
Version
0.3.2
In the catalog
2026-11-12

Known issues (from its catalog listing)

  • Needs the birdie service running on the same machine. Install it from https://github.com/koshikraj/birdie, then run `birdie setup hermes` and restart Hermes.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in coding & developer tools

All coding & developer tools plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins