Hermes profiles and Voice Follow-up
Choose which Hermes profiles use Agent Approve and continue supported CLI and desktop conversations from your phone.
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 profilesThe 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 controls which profiles send Agent Approve events. Voice Follow-up is set separately. The account setting is the default, and each Hermes profile can override it with its own On or Off from the Agents tab. See Voice Follow-up.
Voice Follow-up requirements
Voice Follow-up can continue the same conversation in a compatible interactive Hermes CLI or desktop session. Keep the session open until your reply returns.
You need:
- A current Hermes version with session message injection, and Agent Approve plugin 0.1.14 or later for gateway-backed CLI and desktop sessions
- The plugin enabled for the selected Hermes profile, with permission to return messages through Hermes
- Voice Follow-up set to On for that profile, or Inherit with the account setting enabled
The installer configures the reply permission for each profile you enable. It allows Agent Approve to send your mobile response back to Hermes; the Voice Follow-up setting still controls whether you receive a prompt. Older Hermes versions with a direct interactive CLI remain supported.
The Mobile Q&A setting is separate and is not required for Voice Follow-up.
One-shot commands, cron jobs, Kanban workers, and messaging-channel conversations such as Telegram or Slack receive an Agent Completion notification instead, when enabled. Continue messaging-channel conversations in their original app. Unknown or incompatible session types also receive completion notifications.
To verify the setup, finish a short conversation in Hermes and reply to its Voice Follow-up prompt from your phone. Your reply should start the next turn in that same conversation. With several sessions open, each reply stays with the session that requested it.
If Hermes closes the session before you answer, the reply may be refused. It will not be sent to a different session. Check the hook debug log for follow_up_capability and accepted=False when troubleshooting.
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.
Follow-up runs but is missing from the terminal
In gateway-backed Hermes terminal sessions (started with hermes), a mobile follow-up can run without the message or response appearing in the terminal. This is a known display issue in Hermes. The follow-up stays in the same conversation.
Open that agent's activity in Agent Approve to read the response. Check there before sending the message again, so you do not repeat an action that already ran. Hermes desktop sessions display the follow-up and response normally.
Keep Hermes and the Agent Approve plugin updated. hermes update --check checks for Hermes updates; reinstalling the Agent Approve plugin alone does not fix this terminal display issue.