hermes-agent

Configure, extend, theme, and orchestrate Hermes Agent instances across CLI, desktop, and messaging platforms.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-agent
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/autonomous-ai-agents/hermes-agent
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill hermes-agent-chenhui-x

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 setup, configuration, theming, or orchestration questions correctly requires knowing which of its many subsystems (CLI, gateway, skins, plugins, cron, delegation) applies. This Skill routes every Hermes question to the right reference file or live documentation so answers are accurate instead of guessed. ## Core Features & Use Cases - Guided configuration and operation: Covers installation, provider/model setup, config.yaml sections, toolsets, credentials, profiles, and the full CLI command surface. - Extension and theming: Provides templates and references for building desktop UI plugins, TUI widgets, custom skins, and installing pet mascots. - Multi-agent orchestration: Documents spawning independent Hermes processes via tmux, delegate_task subagents, cron scheduling, and the kanban work queue. - Use Case: A user asks why their delegate_task batch ran fewer subagents than configured; the Skill loads the concurrency-diagnosis reference, checks the three real cap paths in code, and determines whether the model self-limited. ## Quick Start Ask the agent to help you install, configure, theme, or troubleshoot Hermes Agent, 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 install and set up Hermes Agent?

Run the shell installer with curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, then use hermes setup for the wizard, hermes model to pick a provider, and hermes doctor to verify the installation.

How do I spawn multiple Hermes agents in parallel?

Use tmux to run independent Hermes processes, for example tmux new-session -d -s agent1 'hermes -w', then send prompts with tmux send-keys. For quick subtasks, prefer the delegate_task tool instead of full processes.

Why did delegate_task run fewer subagents than I configured?

Hermes has exactly three cap paths: a per-call reject, a per-turn truncator, and a cost-warning log. If none fired in the logs, the model self-limited 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. Add servers under mcp_servers in config.yaml using stdio (command/args) or HTTP (url) transport, and their tools are auto-discovered at startup with the mcp_<server>_<tool> naming prefix.

How do I change the Hermes theme or skin?

Apply a skin with hermes config set display.skin <name>, which repaints every surface live. To tweak one color, edit the active skin with hermes skin set <key> <hex> rather than forking the default skin.

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 are covered in the windows-quirks reference file.