Hermes Agent plugin
The Inkbox Hermes Agent plugin is a standalone platform plugin for Hermes Agent. It gives a Hermes agent its own Inkbox identity: mailbox, phone number, SMS/MMS, voice calls, contact rules, an Inkbox tunnel, realtime phone calls, and bundled Inkbox skills.
This is a plugin, not an Inkbox SDK skill or Hermes fork. It lives in its own repository and wires Inkbox directly into Hermes' plugin system, gateway, tools, CLI, setup wizard, and bundled task skills.
Install
Install and configure upstream Hermes Agent first.
For macOS, Linux, or WSL2:
For native Windows PowerShell:
Install and enable the Inkbox plugin:
Configure Inkbox and start or restart the gateway:
If the gateway is already running, restart it so it reloads the Inkbox platform config. Keep the gateway process running. On startup the plugin opens an Inkbox tunnel, configures mail and text webhook subscriptions, wires the incoming-call URL, and routes inbound email, SMS, and calls into Hermes sessions.
To update an existing install:
What you get
By the end of setup your Hermes agent has:
- An email address - send, receive, and reply from an Inkbox mailbox
- A phone number - SMS/MMS and voice calls, inbound and outbound
- An Inkbox tunnel - inbound webhooks and WebSocket connections reach the local Hermes gateway without a public server
- Contacts and contact rules - persistent Inkbox records and server-side allow/block controls
- Bundled Inkbox skills - email triage, SMS response, contact lookup, outbound calling, notes, and credential workflows
What Inkbox adds
| Capability | Hermes Agent alone | With Inkbox plugin |
|---|---|---|
| Agent-owned mailbox | Bring your own integration | Built in |
| SMS/MMS and voice calls | Bring your own integration | Built in |
| Inbound webhook and WebSocket tunnel | Bring your own tunnel/server | Built in |
| Contact and reachability controls | Agent memory or external tools | Built in |
| Realtime phone-call bridge | Bring your own integration | Built in |
Hermes Agent itself stays upstream. The plugin adds an Inkbox platform adapter, tool group, CLI setup wizard, gateway webhook routing, and package-included task skills without requiring a Hermes fork.
After install
Run a quick health check:
Then text START to the agent's Inkbox phone number from every phone the agent needs to text. This opts that phone number in to SMS from the agent. You can also email the agent mailbox or call the agent phone number; the gateway routes those inbound events into Hermes.
Manage who can reach the agent
Inkbox reachability is controlled server-side with mailbox and phone contact rules in the Inkbox Console. Use the Inkbox console contact rules to allow or block specific contacts, phone numbers, email addresses, or domains. Per-mailbox and per-number filter modes decide whether unmatched senders are allowed by default or rejected.