Hermes profiles and Voice Follow-up

Complete the standard Hermes setup guide first. This page covers the two parts of the Hermes integration that differ from the other plugin integrations: profile selection and the execution modes that can accept Voice Follow-up.

Choose Hermes profiles

Run:

npx agentapprove profiles

The command shows the Hermes profiles found on the computer. Enable the full Agent Approve plugin for the profiles you want to supervise and disable it for the others.

Profile selection does not control Voice Follow-up by itself. Voice Follow-up is one account setting and applies to each enabled integration that supports it.

Voice Follow-up requirements

Hermes can return a follow-up message only to its classic interactive CLI. Keep that CLI session open until the reply returns.

Voice Follow-up does not currently return messages to:

• Gateway sessions, including conversations started through Telegram, Discord, Slack, or another gateway channel
• hermes chat -q and --oneshot runs
• Cron jobs and Kanban workers that use a single-query process

These execution modes can still use Agent Approve for approvals, policy enforcement, activity monitoring, Agent Completion notifications, and push notifications. The limitation applies only to sending another instruction back to Hermes. Continue the conversation through its original gateway channel when needed.

You need:

1. A Hermes profile with the Agent Approve plugin enabled
2. Voice Follow-up enabled in Agent Approve
3. A classic interactive Hermes CLI session that remains open until the mobile reply returns

The Mobile Q&A setting is not part of this Hermes flow. It controls supported Claude Code questions.

The plugin can currently open a follow-up prompt even when Hermes cannot accept the returned message. If you reply from an unsupported execution mode, Hermes rejects the injection and the plugin records accepted=False in the hook debug log. The message does not become the next Hermes turn.

Current limitation

Voice Follow-up cannot be configured per Hermes profile. Disable the Hermes plugin for profiles that should not send Agent Approve events, or turn off Voice Follow-up at the account level for every supported integration.

Update or repair

Run npx agentapprove install again to refresh the plugin. Run npx agentapprove status to check the saved setup. If the selected profiles are wrong, run npx agentapprove profiles.