Hermes Delegation
Freshness check
Before writing or changing any Hermes config, run hermes --version and
hermes update --check, then read
https://github.com/NousResearch/hermes-agent/releases/latest. If the installed
or latest version is newer than 0.23.0, read every release note since 0.23.0
("Upgrade notes" first) and adjust. Never apply guidance from this skill to a
newer version without that check.
Decision map
| Question | Load |
|---|---|
Which delegation.* key, default, conflict |
delegation-keys.md |
| Per-task model choice or "subagent as another profile" | backends-advanced-delegation.md |
| Manager -> workers design, depth, spend | topology-cost.md |
| Copy-paste config | templates/ |
Critical rules
- Subagents know nothing. Each child starts a fresh conversation with only
the
goalandcontextthe parent writes, plus the workspace project context file (.hermes.md> AGENTS.md > ...). SOUL.md is excluded. - Default is flat.
delegation.max_spawn_depthdefaults to1: children are leaves and cannot delegate. One level (manager -> temporary workers) is the recommended pattern. - Set limits explicitly.
max_concurrent_childrenis 10 in code and infeatures/delegation.md, but 3 inconfiguration.md;max_spawn_depthhas no ceiling in code but "1-3, clamped" inconfiguration.mdand the example file. Write the values you want. delegation.reasoning_effortis code-only (present intools/delegate_tool_config.py, undocumented). Use it, but say so, and verify withhermes config get delegation.reasoning_effort.- Backends fail closed. A
delegation.backendwhose plugin is missing returns a tool error; no child starts on another route. profile_routeslends credentials. A listed profile's keys, SOUL.md and terminal policy are used by this profile's children. List only profiles you accept to share.- Leaves cannot call
delegate_task,clarify,memory,send_message,cronjob. Both roles keepexecute_code.
Quick start
hermes config set delegation.model "<WORKER_MODEL_ID>"
hermes config set delegation.provider "<PROVIDER>"
hermes config set delegation.max_spawn_depth 1
hermes config set delegation.max_concurrent_children 10
hermes config get delegation.max_concurrent_children
Watch running children with /agents or Ctrl+T (classic CLI also F6), and
their transcripts under ~/.hermes/cache/delegation/live/ (kept 7 days).
Sources
- https://hermes-agent.nousresearch.com/docs/user-guide/features/delegation
- https://hermes-agent.nousresearch.com/docs/user-guide/configuration (Delegation)
- https://raw.githubusercontent.com/NousResearch/hermes-agent/main/cli-config.yaml.example (
delegation:) - https://github.com/NousResearch/hermes-agent/blob/main/tools/delegate_tool_config.py
- https://hermes-agent.nousresearch.com/docs/developer-guide/delegation-provider-plugin
- https://github.com/NousResearch/hermes-agent/releases/tag/v0.23.0 (pluggable delegation)
