Variáveis de ambiente: Comportamento do agente
49 variáveis em Comportamento do agente
A lista sai da documentação e do código do Hermes Agent, conferidos em 13 de novembro de 2026. Cada variável traz o link para a página oficial de onde o tipo e o padrão foram tirados.
- Versão de referência
- v0.23.1
- Todas as categorias
- Menu das variáveis do Hermes Agent
Substitui o diretório de configuração e autenticação da CLI do Codex quando o runtime app-server está ligado.
Máximo de subagentes em paralelo por lote de delegate_task. O padrão é 3.
Aprova automaticamente hooks de shell novos declarados no config.yaml, sem prompt no terminal.
Variável obsoleta. O Hermes não lê mais esse valor, que não tem efeito.
A documentação informa que a variável não é mais lida pelo Hermes.
Acrescenta texto de orientação ao system prompt em instalações personalizadas.
Substitui o logotipo ASCII mostrado na inicialização da CLI.
Intervalo, em segundos, entre notificações de progresso em turnos longos no gateway.
Tempo de inatividade, em segundos, antes de encerrar um agente em execução no gateway. Com zero, o limite fica desligado.
Segundos de inatividade antes de enviar um aviso no gateway. O padrão é 75% de HERMES_AGENT_TIMEOUT.
Permite que as ferramentas acessem endereços de localhost e da rede privada.
Tempo limite, em segundos, de uma chamada não streaming sem resposta. O padrão é 90.
Tempo limite, em segundos, das chamadas à API do modelo.
Modo de notificação de processos em segundo plano no gateway: concise, all, result, error ou off.
Substitui a lista de skills incluídas carregadas na inicialização.
Tempo limite, em segundos, para criar um checkpoint do sistema de arquivos.
Registra no agent.log o rastreamento detalhado de interrupções e cancelamentos.
Desliga a verificação de arquivo alterado desde a última leitura em patch e write_file.
Política interna que recusa instalações sob demanda. Não coloque no .env.
Variável interna: o Hermes define sozinho e pede para não configurar.
Envia o conteúdo das requisições à API para a saída padrão, em vez dos arquivos de log.
Liga a descoberta automática de plugins do repositório em ./.hermes/plugins/. O padrão é desligado.
System prompt temporário injetado na chamada à API e nunca gravado na sessão.
Liga os prompts de aprovação de execução no modo gateway.
Máximo de reinícios do gateway na janela antes de aplicar espera exponencial. Com zero, o limitador fica desligado.
Janela, em segundos, do limitador de reinícios do gateway.
O Hermes não lê mais esta variável. O ritmo de resposta fica na seção
human_delaydoconfig.yamlde cada perfil.A documentação informa que a variável não é mais lida pelo Hermes.
O Hermes não lê mais esta variável. O ritmo de resposta fica na seção
human_delaydoconfig.yamlde cada perfil.A documentação informa que a variável não é mais lida pelo Hermes.
O Hermes não lê mais esta variável. O ritmo de resposta fica na seção
human_delaydoconfig.yamlde cada perfil.A documentação informa que a variável não é mais lida pelo Hermes.
Não injeta AGENTS.md, SOUL.md, .cursorrules, memória e skills pré-carregadas.
Ignora o config.yaml do usuário e usa os padrões internos. As credenciais do .env continuam carregando.
Substitui o nome do modelo na sessão. Também pode ser definido pela opção -m ou --model.
UUID da tarefa do kanban, definido pelo dispatcher ao criar um worker. Não configure.
Variável interna: o Hermes define sozinho e pede para não configurar.
Tempo limite, em segundos, de stream parado em provedores locais. O padrão é 900.
Máximo de iterações de chamada de ferramenta por conversa. O padrão é 500.
Registra as tentativas de troca e renovação de token OAuth, com os tempos protegidos.
Skills opcionais instaladas automaticamente na primeira execução.
Mostra no stderr os logs detalhados de descoberta de plugins.
Suprime a saída não essencial.
Controla a remoção de segredos na saída das ferramentas, nos logs e nas respostas do chat.
Modo antigo de diagnóstico que ignora plugins, servidores MCP e hooks de shell neste processo.
A documentação informa que a variável não é mais lida pelo Hermes.
Vigia a inicialização de hermes gateway run e encerra com código 75 quando o processo não chega a um event loop ativo.
Tempo limite, em segundos, do vigia de inicialização. O padrão é 300.
Tempo limite, em segundos, de leitura do socket de streaming. O padrão é 120.
Tentativas de reconexão no meio de um stream após erro de rede. O padrão é 3.
Interrompe chamadas após esta quantidade de streams parados seguidos sem resposta completa. O padrão é 5.
Tempo limite, em segundos, para considerar um stream parado. O padrão é 180.
A variável perdeu o suporte na versão mínima de configuração v12 e não tem efeito. Use
display.tool_progressnoconfig.yaml.A documentação informa que a variável não é mais lida pelo Hermes.
Variável de compatibilidade para o modo de progresso das ferramentas. Prefira display.tool_progress.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Restringe write_file e patch aos diretórios informados, que podem ser vários separados pelo separador do sistema.
Ignora os prompts de aprovação de comandos perigosos. Equivale a
--yolo.