hermes-agent

Configure, extend, and troubleshoot the Hermes Agent CLI, gateways, tools, and skills.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/timchap/dot-hermes --skill hermes-agent-timchap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent
Source: https://github.com/timchap/dot-hermes/tree/main/skills/meta/hermes-agent
Command: npx skills add https://github.com/timchap/dot-hermes --skill hermes-agent-timchap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with Hermes Agent involves a large surface area — CLI commands, config.yaml sections, 20+ LLM providers, messaging gateways, MCP servers, webhooks, profiles, and multi-agent spawning — and it is hard to know the right command, setting, or troubleshooting step without digging through the source repository. ## Core Features & Use Cases - CLI & Configuration Reference: Covers the full hermes command surface (chat, setup, model, config, tools, skills, mcp, gateway, sessions, cron, webhook, profile, auth) plus config.yaml sections and provider credentials. - Gateway, MCP & Webhook Setup: Detailed references for connecting 20+ messaging platforms, configuring the native MCP client (stdio/HTTP transports, tool naming, sampling), and creating webhook subscriptions with filters, scripts, and direct delivery. - Multi-Agent Operations: Guidance on spawning additional Hermes instances via one-shot commands or tmux PTY sessions, using profiles for isolation, and coordinating agents with the kanban board. - Use Case: You want Hermes to triage new GitHub issues automatically. Use this Skill to enable the webhook platform, create a subscription with a prompt template, and deliver the agent's triage to Telegram. ## Quick Start Ask the agent to show you how to install Hermes, pick a model provider, and run your first chat command.

Frequently Asked Questions about hermes-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and set up Hermes Agent?▼

Install Hermes Agent with the shell installer (curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash) or via pip install hermes-agent. Then run hermes setup for the interactive wizard, hermes model to pick a provider, and hermes doctor to verify the installation.

How do I connect MCP servers to Hermes Agent?▼

Add servers under the mcp_servers key in ~/.hermes/config.yaml using either a command (stdio) or url (HTTP) transport, then restart Hermes. Tools are auto-discovered and registered with the mcp_{server}_{tool} naming pattern; the mcp Python package must be installed.

Which LLM providers does Hermes Agent support?▼

Hermes supports 20+ providers including OpenRouter, Anthropic, OpenAI, Google Gemini, DeepSeek, xAI, Kimi, MiniMax, and local or custom endpoints via model.base_url. Credentials are managed with hermes auth, which supports OAuth and pooled API keys with automatic rotation.

How do I create a webhook that triggers a Hermes agent run?▼

First enable the webhook platform via hermes gateway setup or the platforms.webhook config section, then run hermes webhook subscribe with a name, prompt template, and delivery target. Each subscription gets an HMAC secret and a URL that external services like GitHub or Stripe can POST to.

Why is Hermes redacting secrets from my tool output?▼

Secret redaction is enabled by default and scans tool output for API keys and tokens before they enter the conversation context. It is snapshotted at startup, so changing security.redact_secrets requires editing the config from a terminal and starting a new session.

When should I spawn a Hermes subprocess instead of using delegate_task?▼

Use delegate_task for quick parallel subtasks that share the parent process and finish in minutes. Spawn a separate hermes process (one-shot or via tmux for interactive PTY mode) when you need full tool access, complete isolation, or long-running autonomous missions lasting hours.