hermes-authyouragent: plugin for Hermes Agent

Hermes plugin that routes web tasks through an Auth Your Agent vault and waits for phone approvals

What hermes-authyouragent does

Auth Your Agent gives an agent a sandboxed browser, called the vault, which asks you on your phone before the agent signs in, buys something or takes another sensitive step. Passwords stay in your password manager and are never shown to the agent. The vault's tools come from its MCP server, authyouragent-mcp, and this plugin adds the parts an MCP server cannot.

While the authyouragent MCP server is configured, Hermes's own browser_* tools are refused with a message pointing to the vault tools, so the model cannot go around the vault. A short system prompt section tells the agent to wait while an approval card is on your phone, and a bundled skill, authyouragent:authyouragent, provides the tool guide. Two settings exist under plugins.entries.authyouragent.settings: server_name and block_builtin_browser, which defaults to true. If the MCP server is not configured or is disabled, the plugin does nothing.

Key features

Refuses Hermes's built-in browser_* tools while the vault server is configured
System prompt section that tells the agent to wait for phone approvals
Bundled skill with the full vault tool guide
Settings for the MCP server name and for the browser block
No effect when the MCP server is absent or disabled

When to use it

Let Hermes shop or sign in on a website while you approve each sensitive step on your phone
Keep passwords out of the agent's view
Stop the model from using the built-in browser as a way around the vault

Who it is for: Hermes Agent users who want browser tasks that need logins or purchases to pass through human approval.

How it fits with Hermes Agent

Built for Hermes Agent as a plugin that works together with the authyouragent-mcp server added through hermes mcp add.

How to install hermes-authyouragent

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

pip install "authyouragent[mcp]"
hermes plugins install kjames2001/hermes-authyouragent
hermes plugins enable authyouragent

Requirements: Docker to run the vault, an agent and key from authyouragent.com, and the authyouragent-mcp server added to Hermes

Note: It depends on the external Auth Your Agent service and does nothing unless the authyouragent MCP server is configured in Hermes.

FAQ

What is hermes-authyouragent?

hermes-authyouragent is a Hermes Agent plugin for Auth Your Agent. It blocks the built-in browser while the vault MCP server is configured and makes the agent wait for your phone approval.

Does hermes-authyouragent work with Hermes Agent?

Yes, it is built for Hermes Agent. Add the authyouragent-mcp server with hermes mcp add, then install and enable the plugin and start a new session.

What do I need to run hermes-authyouragent?

You need Docker to run the vault, an agent and key created at authyouragent.com, and the authyouragent-mcp server configured in Hermes. Approvals arrive as cards on your phone.