hermes config Befehl — Vollständige Referenz & Beispiele

Überblick

hermes config verwaltet die Hauptkonfigurationsdatei unter ~/.hermes/config.yaml. Diese Datei steuert jeden Verhaltensaspekt von Hermes Agent — Modelle, Provider, Tools, Terminal-Backends, Komprimierung, Genehmigungen und mehr.

hermes config <show|edit|get|set|unset|path|env-path|check|migrate>

Wichtig: API-Schlüssel und andere Secrets werden in ~/.hermes/.env gespeichert, nicht in config.yaml.

Unterbefehle

show — Aktuelle Konfiguration anzeigen

hermes config show

Gibt die aufgelöste ~/.hermes/config.yaml aus.

edit — Konfigurationsdatei im Editor öffnen

hermes config edit

Öffnet ~/.hermes/config.yaml in deinem $EDITOR.

get — Aufgelösten Konfigurationswert ausgeben

hermes config get model
hermes config get terminal.backend
hermes config get approvals.mode --json

set — Konfigurationswert setzen

hermes config set terminal.backend docker
hermes config set model claude-sonnet-4-20250514
hermes config set approvals.deny "rm -rf *,curl *" --force

unset — Konfigurationswert entfernen

hermes config unset display.interface

Entfernt den angegebenen Schlüssel aus config.yaml.

path — Pfad der Konfigurationsdatei ausgeben

hermes config path

Gibt den vollständigen Pfad zu ~/.hermes/config.yaml aus.

env-path — Pfad der .env-Datei ausgeben

hermes config env-path

Gibt den vollständigen Pfad zur Secrets-.env-Datei aus.

check — Fehlende/veraltete Konfiguration prüfen

hermes config check

Validiert die Konfiguration und meldet fehlende oder veraltete Optionen.

migrate — Konfiguration mit neuen Optionen aktualisieren

hermes config migrate

Schreibt die Konfiguration um, um neue Standardoptionen hinzuzufügen und veraltete Schlüssel zu aktualisieren.

Häufige Szenarien

Standardmodell auslesen

hermes config get model

Terminal-Backend wechseln

hermes config set terminal.backend docker

Einstellung entfernen

hermes config unset display.interface

Nach manuellen Bearbeitungen validieren

hermes config edit
hermes config check

Konfiguration für eine neue Hermes-Version aktualisieren

hermes config migrate

Pfade von Konfiguration und Secrets anzeigen

hermes config path
hermes config env-path

Tipps

• Verwende Punktnotation für verschachtelte Schlüssel: terminal.backend, approvals.mode, auxiliary.approval.model.
• hermes config set schreibt sofort und ist idempotent.
• hermes config check findet Tippfehler und Schema-Drift nach manuellen Bearbeitungen.
• hermes config migrate vor einem Upgrade ist sicher; prüfe das Diff, wenn deine Config unter Versionskontrolle steht.
• Für CI/Headless-Setups verwende hermes config set statt des interaktiven Editors.