Comando hermes config — Referencia Completa y Ejemplos

Descripción General

hermes config gestiona el archivo de configuración principal en ~/.hermes/config.yaml. Este archivo controla todos los aspectos del comportamiento de Hermes Agent: modelos, proveedores, herramientas, backends de terminal, compresión, aprobaciones y más.

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

Importante: Las claves API y otros secretos se almacenan en ~/.hermes/.env, no en config.yaml.

Subcomandos

show — Ver configuración actual

hermes config show

Imprime el ~/.hermes/config.yaml resuelto.

edit — Abrir configuración en el editor

hermes config edit

Abre ~/.hermes/config.yaml en tu $EDITOR.

get — Imprimir un valor de configuración resuelto

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

set — Establecer un valor de configuración

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

unset — Eliminar un valor de configuración

hermes config unset display.interface

Elimina la clave especificada de config.yaml.

path — Mostrar ruta del archivo de configuración

hermes config path

Muestra la ruta completa a ~/.hermes/config.yaml.

env-path — Mostrar ruta del archivo .env

hermes config env-path

Muestra la ruta completa al archivo de secretos .env.

check — Comprobar configuración obsoleta o faltante

hermes config check

Valida la configuración e informa opciones faltantes u obsoletas.

migrate — Actualizar configuración con nuevas opciones

hermes config migrate

Reescribe la configuración para agregar nuevas opciones por defecto y actualizar claves obsoletas.

Escenarios Comunes

Leer el modelo predeterminado

hermes config get model

Cambiar el backend de terminal

hermes config set terminal.backend docker

Eliminar una opción

hermes config unset display.interface

Validar tras ediciones manuales

hermes config edit
hermes config check

Actualizar la configuración para una nueva versión de Hermes

hermes config migrate

Encontrar dónde residen configuración y secretos

hermes config path
hermes config env-path

Consejos

• Usa notación de punto para claves anidadas: terminal.backend, approvals.mode, auxiliary.approval.model.
• hermes config set escribe inmediatamente y es idempotente.
• hermes config check detecta errores tipográficos y desviaciones del esquema tras ediciones manuales.
• Es seguro ejecutar hermes config migrate antes de actualizar; revisa el diff si tu configuración está bajo control de versiones.
• Para configuraciones CI/headless, prefiere hermes config set en lugar del editor interactivo.