Hermes Agent Setup

Two integration options: a native plugin that registers Pushary tools directly in Hermes, or an MCP server connection. The native plugin is recommended because it includes automatic error notifications and session-end alerts.

Native plugin (recommended)

pip install hermes-plugin-pushary
hermes plugins enable pushary

Set your API key in your shell profile:

export PUSHARY_API_KEY="pk_abc123.sk_xyz789"

What you get

The plugin registers 4 native Hermes tools:

Plus two automatic hooks:

• post_tool_call: sends a push notification when any tool returns an error (up to 3 per session)
• on_session_end: notifies you when a Hermes session ends (opt-in)

Configuration

Set these environment variables to customize behavior:

When to use Pushary vs Hermes platforms

Hermes supports 21+ messaging platforms (Telegram, Discord, Slack, etc.). Use Pushary when:

• The user has no active chat session
• You need to reach the user's phone lock screen for a quick decision
• A background task or cron job finishes
• Permission escalation for dangerous commands

Use the active Hermes platform when:

• The user is currently in a Telegram/Discord/Slack conversation
• The question is part of an ongoing dialog

MCP server (alternative)

If you prefer MCP over the native plugin:

mcp:
  servers:
    pushary:
      url: https://pushary.com/api/mcp/sse
      headers:
        Authorization: "Bearer ${PUSHARY_API_KEY}"

hermes skills tap add Pushary/pushary-skill
hermes skills install pushary

The MCP approach gives you the same tools (send_notification, ask_user, wait_for_answer, cancel_question) but without automatic error notifications or session-end hooks.

Permission gating

Hermes does not have a pre-tool-call hook that can block execution, so permission gating works differently than Claude Code or Codex.

The Pushary skill includes a mandatory permission gating rule that instructs Hermes to call pushary_ask before executing dangerous operations:

• File deletion
• Database mutations
• Deployment commands
• Git history rewrites
• System administration

Hermes follows this instruction and waits for your approval via push notification before proceeding. If you don't respond after 3 attempts, the operation is skipped.

This is a prompt-level constraint, not an enforced hook. Hermes follows it reliably, but it is not physically blocked from executing without approval the way Claude Code is.

Skill tap

Register the Pushary skill repository so Hermes can discover and install skills from it:

hermes skills tap add Pushary/pushary-skill

This makes both the general Pushary skill and the Hermes-specific skill available:

hermes skills install pushary

The skill teaches Hermes when to send push notifications proactively and how to choose between Pushary and the active chat platform.