Hermes Agent plugin
The Inkbox Hermes Agent plugin is a standalone platform plugin for Hermes Agent. It connects a Hermes agent to an Inkbox identity and supports email, SMS/MMS and voice calls, iMessage, contact rules, an Inkbox tunnel, realtime phone calls, and bundled Inkbox skills when those capabilities are configured.
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:
The setup wizard creates or connects an Inkbox agent, offers to provision a phone number, offers to connect iMessage, configures signed inbound messaging, and offers several phone-call voice stacks when a calling channel is available.
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, text, and iMessage webhook subscriptions, wires the incoming-call URL, and routes configured email, SMS/MMS, iMessage, and call channels into Hermes sessions.
To update an existing install:
Available capabilities
Depending on your setup choices and account availability, your Hermes agent can have:
- An email address - send, receive, and reply from an Inkbox mailbox
- A phone number, when available - SMS/MMS and voice calls, inbound and outbound
- iMessage, when connected - continue Hermes conversations from iMessage threads
- 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 | Available when configured |
| iMessage | Bring your own integration | Available when configured |
| 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 | Available when configured |
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:
Use any channels you configured. If the agent has a phone number, text START to it 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, use iMessage when connected, or call the agent phone number when available; the gateway routes each configured channel into Hermes.
Manage who can reach the agent
Inkbox reachability is controlled server-side with per-agent contact rules. Use the Inkbox console contact rules to allow or block specific contacts, phone numbers, email addresses, or domains. Each agent identity's mail and phone filter modes decide whether unmatched senders are allowed by default or rejected.