Hermes Config YAML Field Guide

Hermes stores user configuration in config.yaml. Most users should start with hermes setup and hermes model, then edit the file only when they understand the setting they are changing.

Common commands

hermes config
hermes config path
hermes config edit
hermes config set section.key value
hermes config check

Important sections

model: default provider, model, base URL, API key reference, and context settings
terminal: where commands run and default timeout behavior
agent: turn limits and tool-use behavior
compression: context compression thresholds for long sessions
display: skin, reasoning display, and interface preferences
memory: memory provider and whether memory is enabled
security: redaction, blocklists, and safety toggles
gateway: messaging platform configuration when enabled

Secrets rule

Do not paste secrets into public docs, screenshots, social posts, or wiki articles. API keys and tokens belong in the appropriate environment or auth store, not in examples.

Safe beginner workflow

Run hermes setup.
Choose a model with hermes model.
Run hermes doctor.
Enable only the tools needed.
Start a new session after major config changes.

Verification

After config edits, run hermes config check or hermes doctor before depending on the setup.