Skip to content

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.

View plugin on GitHub

Install

Install and configure upstream Hermes Agent first.

For macOS, Linux, or WSL2:

bashbash

For native Windows PowerShell:

bashbash

Install and enable the Inkbox plugin:

bashbash

Configure Inkbox and start or restart the gateway:

bashbash

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:

bashbash

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

CapabilityHermes Agent aloneWith Inkbox plugin
Agent-owned mailboxBring your own integrationBuilt in
SMS/MMS and voice callsBring your own integrationAvailable when configured
iMessageBring your own integrationAvailable when configured
Inbound webhook and WebSocket tunnelBring your own tunnel/serverBuilt in
Contact and reachability controlsAgent memory or external toolsBuilt in
Realtime phone-call bridgeBring your own integrationAvailable 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:

bashbash

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.