Comando hermes — Referência Completa e Exemplos

Visão Geral

hermes é o ponto de entrada principal do Hermes Agent. Executá-lo sem nenhum subcomando inicia uma sessão de chat interativa na interface configurada (TUI ou REPL clássico) — equivalente a hermes chat. A CLI também expõe dezenas de subcomandos para configuração, integrações, skills, sessões e manutenção.

hermes [opções] [comando]

Opções Globais

Opção	Descrição
`-h, --help`	Mostra a ajuda e sai.
`--version, -V`	Mostra as informações de versão e sai.
`-z PROMPT, --oneshot PROMPT`	Modo one-shot: envia um único prompt e imprime somente a resposta final no stdout. Sem banner, spinner ou linha de session ID — ideal para scripts e pipes.
`--usage-file PATH`	Somente no modo one-shot: grava um relatório de uso em JSON (custo, contagens de tokens, modelo, api_calls) em PATH após a execução.
`-m MODEL, --model MODEL`	Substitui o modelo nesta invocação (ex.: `anthropic/claude-sonnet-4.6`). Aplica-se a `--oneshot` e `--tui`.
`--provider PROVIDER`	Substitui o provedor (ex.: `openrouter`, `anthropic`). Aplica-se a `--oneshot` e `--tui`.
`--reasoning LEVEL`	Esforço de raciocínio: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` ou `ultra`.
`-t TOOLSETS, --toolsets TOOLSETS`	Toolsets separados por vírgula a habilitar nesta invocação.
`--resume SESSION, -r SESSION`	Retoma uma sessão anterior por ID ou título.
`--no-restore-cwd`	Não entra no diretório de trabalho registrado da sessão retomada.
`--continue [SESSION_NAME], -c [SESSION_NAME]`	Retoma uma sessão por nome, ou a mais recente se nenhum nome for informado.
`--worktree, -w`	Executa em um git worktree isolado (para agentes paralelos).
`--accept-hooks`	Aprova automaticamente shell hooks não vistos sem prompt de TTY (útil em CI e headless).
`--skills SKILLS, -s SKILLS`	Pré-carrega uma ou mais skills para a sessão (flag repetível ou separadas por vírgula).
`--yolo`	Ignora todos os prompts de aprovação de comandos perigosos (use por sua conta e risco).
`--pass-session-id`	Inclui o ID da sessão no system prompt do agente.
`--ignore-user-config`	Ignora `~/.hermes/config.yaml` e usa os padrões internos (credenciais em `.env` ainda são carregadas).
`--ignore-rules`	Ignora a injeção automática de `AGENTS.md`, `SOUL.md`, `.cursorrules`, memória e skills pré-carregadas.
`--safe-mode`	Modo de diagnóstico: desativa TODAS as personalizações — configuração do usuário, injeção de memória, plugins e servidores MCP. Implica `--ignore-user-config` e `--ignore-rules`.
`--tui`	Inicia a TUI moderna em vez do REPL clássico.
`--cli`	Força o REPL clássico do `prompt_toolkit` (substitui `display.interface=tui`).
`--dev`	Com `--tui`: executa fontes TypeScript via `tsx` (ignora o build dist).
`--profile PROFILE, -p PROFILE`	Executa sob um perfil Hermes nomeado (define `HERMES_HOME`). Consumido antes da análise de argumentos, funciona com qualquer subcomando.

Subcomandos

O hermes traz mais de sessenta subcomandos. Os principais grupos:

Grupo	Subcomandos
Chat e modelos	`chat`, `model`, `moa`, `fallback`, `acp`
Integrações e mensageria	`gateway`, `whatsapp`, `whatsapp-cloud`, `slack`, `send`, `webhook`, `portal`, `proxy`, `mcp`, `lsp`, `computer-use`
Configuração e acesso	`setup`, `config`, `profile`, `project`, `secrets`, `egress`, `skin`, `console`, `pairing`, `approvals`, `auth`, `login`, `logout`
Sessões, memória e análise	`sessions`, `memory`, `journey` (alias de `learning` + `memory-graph`), `checkpoints`, `insights`, `prompt-size`, `logs`
Skills e extensões	`skills`, `bundles`, `plugins`, `curator`, `pets`, `sync`
Gestão e administração	`status`, `doctor`, `security`, `cron`, `hooks`, `backup`, `import`, `import-agent`, `migrate`, `dump`, `debug`, `monitoring`, `version`, `update`, `uninstall`, `completion`, `dashboard`, `serve`, `desktop` (alias `gui`), `claw`, `kanban`, `tools`

Execute hermes <comando> --help para detalhes de qualquer subcomando.

Exemplos

hermes                          # Inicia o chat interativo
hermes chat -q "Hello"          # Modo de consulta única
hermes -z "Summarize this repo" # Modo one-shot: imprime apenas a resposta
hermes --tui                    # Inicia a TUI moderna
hermes --cli                    # Força o REPL clássico
hermes -c                       # Retoma a sessão mais recente
hermes -c "my project"          # Retoma uma sessão por nome
hermes --resume <session_id>    # Retoma uma sessão específica por ID
hermes -m anthropic/claude-sonnet-4.6 --reasoning high   # Substitui modelo + raciocínio
hermes -t web -s hermes-agent-dev,github-auth            # Toolset + skills pré-carregadas
hermes --profile work           # Executa sob o perfil 'work'
hermes setup                    # Executa o assistente de configuração
hermes model                    # Seleciona o modelo padrão
hermes config edit              # Edita a configuração no $EDITOR
hermes gateway install          # Instala o serviço de gateway em segundo plano
hermes sessions list            # Lista sessões anteriores
hermes logs -f                  # Segue agent.log em tempo real
hermes dashboard                # Inicia o dashboard web (porta 9119)
hermes update                   # Atualiza para a versão mais recente

Dicas

hermes sem argumentos inicia o chat interativo — equivalente a hermes chat.
Use --tui para a interface em tela cheia, ou defina display.interface: tui no config.yaml para torná-la o padrão.
-c/--continue retoma a sessão mais recente; -r/--resume tem como alvo um ID de sessão específico.
-z/--oneshot é feito para scripts e pipes; combine com --usage-file para acompanhar gastos.
--safe-mode desativa todas as personalizações — a primeira coisa a tentar quando algo quebrar.
--yolo ignora todos os prompts de aprovação; use apenas em ambientes confiáveis e isolados.
--profile/-p é processado antes da análise de argumentos, então funciona com qualquer subcomando.