hermes-agent

Configure, theme, extend, and orchestrate Hermes Agent across CLI, desktop, and gateway surfaces.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill hermes-agent-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/autonomous-ai-agents/hermes-agent
Command: npx skills add https://github.com/Chia1104/agent-air --skill hermes-agent-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hermes Agent is a large, multi-surface AI agent framework, and answering questions about its CLI commands, configuration, theming, plugins, MCP servers, or multi-agent orchestration requires accurate, up-to-date reference material rather than guesswork. ## Core Features & Use Cases - Routed reference hub: A routing table maps each user question (CLI flags, providers, skins, desktop plugins, TUI widgets, pets, cron, kanban, MCP) to the correct reference file before answering. - Multi-agent orchestration: Spawn independent Hermes subprocesses in one-shot or interactive tmux PTY mode, coordinate multiple agents, and resume sessions. - Extension authoring: Templates and guides for building skins (skin.yaml), desktop UI plugins (plugin.js), and TUI widgets (clock.mjs) that hot-reload into the app. - Use Case: A user asks why their delegate_task batch was capped at 9 despite setting max_concurrent_children to 15; the skill loads the concurrency-diagnosis reference and walks through config checks and log inspection to identify the real cause. ## Quick Start Ask the agent to help you configure a Hermes provider, create a custom skin, or spawn a background Hermes instance for a long-running task.

Frequently Asked Questions about hermes-agent

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

FAQPage Schema
How do I spawn multiple Hermes agents in parallel?▼

Use tmux to run each Hermes instance as an independent subprocess with its own session and tools. Start with tmux new-session -d -s name 'hermes -w', send prompts via tmux send-keys, and read output with tmux capture-pane. For quick subtasks, prefer the delegate_task tool instead.

How do I configure providers and API keys in Hermes Agent?▼

Run hermes model for an interactive picker or hermes setup for the wizard. API keys go in ~/.hermes/.env while non-secret settings go in config.yaml. Hermes supports 35+ providers including OpenRouter, Anthropic, OpenAI, Gemini, and OAuth-based providers via hermes auth add.

Can Hermes Agent connect to MCP servers?▼

Yes, Hermes has a built-in MCP client configured under mcp_servers in config.yaml, supporting both stdio and HTTP transports. Discovered tools are registered with the mcp__server__tool naming pattern and injected into all platform toolsets automatically.

Why was my delegate_task batch capped below my configured limit?▼

Hermes has exactly three cap paths: a per-call hard reject, a per-turn truncator, and a cost-warning log line. Check hermes config get delegation.max_concurrent_children and grep the agent log for Truncated or Too many tasks lines; if none fired, the model self-limited the batch.

How do I create a custom theme for the Hermes desktop app?▼

Copy the skin.yaml template to ~/.hermes/skins/<name>.yaml, edit the palette, then apply it with hermes config set display.skin <name>. Every surface repaints live within about a second; to tweak one color, edit the active skin with hermes skin set rather than forking default.

Does Hermes Agent work on Windows?▼

Yes, Hermes runs on Linux, macOS, Windows, and WSL. Windows-specific issues such as keybind conflicts, WinError 10106, and BOM encoding problems are covered in the windows-quirks reference file included with the skill.