Commande hermes config — Référence Complète & Exemples

Vue d’ensemble

hermes config gère le fichier de configuration principal situé dans ~/.hermes/config.yaml. Ce fichier contrôle tous les aspects comportementaux d’Hermes Agent — modèles, fournisseurs, outils, backends de terminal, compression, approbations, etc.

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

Important : Les clés API et autres secrets sont stockés dans ~/.hermes/.env, pas dans config.yaml.

Sous-commandes

show — Afficher la configuration actuelle

hermes config show

Affiche le ~/.hermes/config.yaml résolu.

edit — Ouvrir la configuration dans l’éditeur

hermes config edit

Ouvre ~/.hermes/config.yaml dans votre $EDITOR.

get — Afficher une valeur de configuration résolue

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

set — Définir une valeur de configuration

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

unset — Supprimer une valeur de configuration

hermes config unset display.interface

Supprime la clé spécifiée de config.yaml.

path — Afficher le chemin du fichier de configuration

hermes config path

Affiche le chemin complet vers ~/.hermes/config.yaml.

env-path — Afficher le chemin du fichier .env

hermes config env-path

Affiche le chemin complet vers le fichier .env des secrets.

check — Vérifier les options manquantes ou obsolètes

hermes config check

Valide la configuration et signale les options manquantes ou obsolètes.

migrate — Mettre à jour la configuration avec les nouvelles options

hermes config migrate

Réécrit la configuration pour ajouter les nouvelles options par défaut et mettre à jour les clés obsolètes.

Scénarios courants

Lire le modèle par défaut

hermes config get model

Changer le backend de terminal

hermes config set terminal.backend docker

Supprimer un paramètre

hermes config unset display.interface

Valider après des modifications manuelles

hermes config edit
hermes config check

Mettre à jour la configuration pour une nouvelle version d’Hermes

hermes config migrate

Trouver où résident la configuration et les secrets

hermes config path
hermes config env-path

Astuces

• Utilisez la notation par points pour les clés imbriquées : terminal.backend, approvals.mode, auxiliary.approval.model.
• hermes config set écrit immédiatement et est idempotent.
• hermes config check détecte les fautes de frappe et les écarts de schéma après des modifications manuelles.
• hermes config migrate est sûr à exécuter avant une mise à jour ; examinez le diff si votre config est sous contrôle de version.
• Pour les configurations CI/headless, préférez hermes config set à l’éditeur interactif.