Comando hermes chat — Referência completa e exemplos

Visão geral

hermes chat inicia uma conversa interativa com o Hermes Agent. Sem argumentos, abre o REPL/TUI padrão. Com -q, executa uma única consulta e sai. Você pode substituir o modelo, provedor, toolsets, skills, esforço de raciocínio, gerenciamento de sessões e comportamento de segurança/aprovação.

Uso

hermes chat [OPÇÕES]
hermes           # atalho para hermes chat

Opções

Flag	Descrição
`-q CONSULTA`, `--query CONSULTA`	Consulta única (modo não interativo).
`--image IMAGEM`	Anexa uma imagem local a uma consulta única.
`-m MODELO`, `--model MODELO`	Substitui o modelo para esta sessão.
`-t LISTA`, `--toolsets LISTA`	Toolsets a habilitar, separados por vírgulas.
`--reasoning NÍVEL`	Esforço de raciocínio: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`, `ultra`.
`-s SKILLS`, `--skills SKILLS`	Pré-carrega um ou mais skills (separados por vírgulas ou repetidos).
`--provider PROVEDOR`	Substitui o provedor de inferência.
`-v`, `--verbose`	Saída detalhada.
`-Q`, `--quiet`	Modo silencioso para uso programático (suprime banner, spinner e prévias de ferramentas).
`--resume ID_SESSÃO`, `-r ID_SESSÃO`	Retoma uma sessão anterior por ID.
`--no-restore-cwd`	Não muda para o diretório de trabalho registrado da sessão retomada.
`--continue [NOME]`, `-c [NOME]`	Retoma uma sessão por nome; omita para a mais recente.
`--worktree`, `-w`	Executa em um git worktree isolado (para agentes paralelos).
`--accept-hooks`	Aprova automaticamente hooks de shell não vistos.
`--checkpoints`	Habilita checkpoints do sistema de arquivos antes de operações destrutivas.
`--max-turns N`	Máximo de iterações de chamadas de ferramentas por turno (padrão 500 ou `agent.max_turns`).
`--yolo`	Ignora todos os prompts de aprovação de comandos perigosos.
`--pass-session-id`	Inclui o ID da sessão no system prompt.
`--ignore-user-config`	Ignora `~/.hermes/config.yaml` e usa valores padrão internos.
`--ignore-rules`	Ignora `AGENTS.md`, `SOUL.md`, injeção de memória e skills pré-carregados.
`--safe-mode`	Desativa todas as personalizações (config, regras, plugins, servidores MCP).
`--source FONTE`	Etiqueta de origem da sessão (padrão: `cli`).
`--tui`	Inicia a TUI moderna.
`--cli`	Força o REPL clássico do prompt_toolkit.
`--dev`	Com `--tui`: executa fontes TypeScript via `tsx`.

Exemplos

# Sessão interativa
hermes chat

# Consulta única
hermes chat -q "Explique a estrutura do projeto"

# Usar modelo e toolsets específicos
hermes chat -q "Refatore o módulo de autenticação" -m anthropic/claude-sonnet-4 -t file,terminal

# Anexar uma imagem
hermes chat --image ~/screenshot.png -q "Descreva esta interface"

# Retomar a sessão mais recente
hermes chat -c

# Retomar uma sessão por nome
hermes chat -c "sessão de debug"

# Pré-carregar skills e executar em worktree isolado
hermes chat -s git-workflow,code-review --worktree

# Habilitar checkpoints e ignorar aprovações para automação
hermes chat --checkpoints --yolo -q "Execute a suite de testes completa"

# Saída programática silenciosa
hermes chat -Q -q "Retorne apenas a lista de arquivos"

# Diagnóstico: execução completamente isolada
hermes chat --safe-mode

Dicas

Use -Q ao canalizar ou scriptar; a saída contém apenas a resposta final e as informações da sessão.
Use --checkpoints ao executar operações destrutivas para poder restaurar com /rollback.
Use --reasoning para aumentar ou diminuir o esforço de raciocínio de uma sessão.
--safe-mode é a forma mais rápida de verificar se um problema é causado pela sua config, regras ou plugins.

Veja também

hermes, hermes model, hermes sessions, hermes tools, /help na sessão.