Comando hermes config — Referência Completa e Exemplos

Visão Geral

hermes config gerencia o arquivo de configuração principal em ~/.hermes/config.yaml. Este arquivo controla todos os aspectos comportamentais do Hermes Agent — modelos, provedores, ferramentas, backends de terminal, compressão, aprovações e mais.

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

Importante: Chaves de API e outros segredos são armazenados em ~/.hermes/.env, não no config.yaml.

Subcomandos

show — Visualizar configuração atual

hermes config show

Exibe o ~/.hermes/config.yaml resolvido.

edit — Abrir configuração no editor

hermes config edit

Abre ~/.hermes/config.yaml no seu $EDITOR.

get — Imprimir um valor de configuração resolvido

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

set — Definir um valor de configuração

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

unset — Remover um valor de configuração

hermes config unset display.interface

Remove a chave especificada do config.yaml.

path — Mostrar caminho do arquivo de configuração

hermes config path

Exibe o caminho completo para ~/.hermes/config.yaml.

env-path — Mostrar caminho do arquivo .env

hermes config env-path

Exibe o caminho completo para o arquivo .env de segredos.

check — Verificar configuração ausente/obsolete

hermes config check

Valida a configuração e reporta opções ausentes ou obsoletas.

migrate — Atualizar configuração com novas opções

hermes config migrate

Reescreve a configuração para adicionar novas opções padrão e atualizar chaves obsoletas.

Cenários Comuns

Ler o modelo padrão

hermes config get model

Alterar o backend de terminal

hermes config set terminal.backend docker

Remover uma configuração

hermes config unset display.interface

Validar após edições manuais

hermes config edit
hermes config check

Atualizar config para nova versão do Hermes

hermes config migrate

Encontrar onde residem config e segredos

hermes config path
hermes config env-path

Dicas

• Use notação de ponto para chaves aninhadas: terminal.backend, approvals.mode, auxiliary.approval.model.
• hermes config set escreve imediatamente e é idempotente.
• hermes config check captura erros de digitação e desvio de esquema após edições manuais.
• É seguro executar hermes config migrate antes de atualizar; revise o diff se sua config estiver sob controle de versão.
• Para configurações CI/headless, prefira hermes config set em vez do editor interativo.