Hermes Agent

The plugin gives Hermes Agent the Inbox tool in your own sessions. Your reply starts a turn in the session that asked.

Native plug-in · Inbox built in and your reply wakes it

Set it up

Install Plannotator 0.28.63 or newer. The same command updates an older one.

curl -fsSL https://plannotator.ai/install.sh | bash
Add the plugin.

hermes plugins install backnotprop/plannotator/apps/hermes-plugin --enable
Open the Inbox. It connects the agents it finds on this computer.

plannotator inbox

You should see The terminal says Connected Hermes Agent … to the Inbox and that Plannotator turned on Hermes Agent’s plugins.entries.plannotator.allow_gateway_injection so your replies can start a turn in the session that asked.
plannotator inbox turned the tool on when it found the plugin. Start a new Hermes session.

You should see The session has a plannotator_inbox tool.

Other ways

Let replies start a turn yourself

Run this when plannotator inbox couldn’t. It applies without restarting Hermes.

hermes config set plugins.entries.plannotator.allow_gateway_injection true

Turn the tool on by hand

Merge this into your Plannotator config. The Inbox must have run once on this computer. It applies to new Hermes sessions.

~/.plannotator/config.json

{ "inboxTool": { "hermes": true } }

Check it works

Paste this into Hermes Agent.

Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it.

You should see A question arrives in the Inbox. Answer it and press Send. The thread reads Delivered to Hermes Agent and Hermes Agent goes on with your answer.

Troubleshooting

Hermes has no plannotator_inbox tool: Run plannotator inbox once: it turns the tool on when it finds the plugin. If you turned the tool off yourself, turn it on in Settings → Agents. Then start a new Hermes session. A running one keeps the tools it started with.
Your reply never shows up on its own: Hermes hasn’t let the plugin start a turn. Run this. Until then your reply is saved and Hermes sees it when it next reads the thread.

hermes config set plugins.entries.plannotator.allow_gateway_injection true
The classic command-line window doesn’t show your reply: In Hermes’s classic command-line window (hermes) your reply still starts a turn and is saved in the session, but that window doesn’t show it. Hermes’s TUI (hermes --tui) shows your reply and the answer as they happen.
The tool refuses in a chat: Only your own sessions get it: the terminal and the TUI and the Desktop app and your own direct messages. Your direct messages count when you are on that platform’s DM admin list (allow_admin_from) or when its allowlist names only you.
No Send now: Hermes takes a reply only when the session is idle, so there is no Send now.
You want replies to stop starting turns: Turn the setting off. Hermes then sees your replies when it reads the thread.

hermes config set plugins.entries.plannotator.allow_gateway_injection false
The Inbox doesn’t open: Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

Inbox tool Built in, off at first
Reply wakes it Wakes it
Start from Inbox No
Permission cards No

Plan review No
Code review No
Annotate No
Ask this session No

Your reply starts a turn only while one Hermes setting is on. plannotator inbox turns it on for you. With it off your reply is saved and Hermes sees it only when it next reads the thread.
In Hermes’s classic command-line window (hermes) your reply still starts a turn and is saved in the session, but that window doesn’t show it. Hermes’s TUI (hermes --tui) shows your reply and the answer as they happen.
Hermes and Plannotator must run on the same computer.
Tested on Hermes Agent 0.23.1 on Linux, with a stand-in model. Not yet tested on macOS, in the Desktop app, or with real chat accounts.
Not verified on Windows.

Examples

Ask Hermes to send you a question with options and pick one in the Inbox.
Write to a Hermes session from New message in the Inbox.

Every agent