hermes-agent

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

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill hermes-agent-iceheartgith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-agent
Source: https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux/tree/main/custom-skills/autonomous-ai-agents/hermes-agent
Command: npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill hermes-agent-iceheartgith

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 finding the right command, config key, or extension mechanism for a given task is difficult without deep knowledge of its CLI, config.yaml structure, gateway platforms, and plugin systems. This Skill acts as a routing hub that directs the agent to the correct reference file before answering, preventing hallucinated commands and misconfigured setups. ## Core Features & Use Cases - CLI and configuration guidance: Covers global flags, chat modes, provider/model setup, toolsets, credential pools, profiles, and session management via hermes subcommands. - Extension and theming: Provides templates and procedures for custom skins (skin.yaml), desktop UI plugins (plugin.js), TUI widgets (clock.mjs), and pet mascots. - Multi-agent orchestration: Documents spawning independent Hermes subprocesses via tmux, delegate_task concurrency behavior, cron scheduling, and the kanban work queue. - Use Case: A user asks why their delegate_task batch of 15 tasks only ran 9. The Skill routes to the concurrency diagnosis reference, which identifies the three real cap paths and explains model self-limiting behavior. ## Quick Start Ask the agent to help you configure a Hermes provider, create a custom theme, or spawn a background Hermes instance, and it will load the matching reference file before answering.

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 Agent instances in parallel?▼

Use tmux to launch independent Hermes processes, for example `tmux new-session -d -s agent1 'hermes'`, then send prompts with `tmux send-keys`. For quick subtasks, prefer the delegate_task tool, which has lower overhead than a full process.

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

Run `hermes model` for the interactive picker or `hermes setup` for the wizard. API keys go in ~/.hermes/.env while settings go in config.yaml; multiple credentials per provider form an automatically rotating pool managed via `hermes auth`.

Why did delegate_task run fewer subagents than I requested?▼

Hermes has exactly three cap paths: a per-call hard reject, a per-turn truncator, and a cost-warning log. If none fired in the logs, the model itself trimmed the batch; instruct it explicitly to send all tasks in one delegate_task call.

Can Hermes Agent connect to MCP servers?▼

Yes, Hermes has a built-in MCP client configured under `mcp_servers` in config.yaml, supporting stdio and HTTP transports. Tools are auto-discovered at startup and registered with the `mcp_{server}_{tool}` naming prefix.

How do I create a custom theme for Hermes Agent?▼

Copy the skin.yaml template to ~/.hermes/skins/<name>.yaml, edit the palette, then apply it with `hermes config set display.skin <name>`. To tweak one color, edit the active skin with `hermes skin set <key> <hex>` rather than forking the default.

Does Hermes Agent work on Windows?▼

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.