Guia rápido da CLI do Hermes Agent — comandos, flags e atalhos com barra

Comandos de shell e TUI para o Hermes Agent auto-hospedado.

Conteúdo da página

O Hermes Agent da Nous Research é um assistente agnóstico a modelos e utilizador de ferramentas, que executa localmente ou num VPS, a partir da shell, de uma TUI em ecrã inteiro ou de um gateway de mensagens.

O Hermes não o prende a uma única interface. Pode utilizar:

  • a CLI clássica hermes / hermes chat,
  • a sessão em ecrã inteiro hermes --tui,
  • um hermes gateway em execução prolongada para Telegram, Discord, Slack e outras plataformas de mensagens,
  • hermes dashboard para uma interface de browser local quando o extra da web está instalado.

Estes caminhos partilham a mesma configuração e dados em ~/.hermes; esta página lista comandos de shell importantes em todos esses modos.

Hermes Agent CLI cheat sheet — terminal reference

Abaixo encontra-se uma referência densa de comandos agrupada por tarefa, verificada em relação à referência oficial de comandos da CLI em 6 de outubro de 2026. A última tag estável nessa data é v0.21.5 (v2026.9.24).

Instalação do Hermes Agent e comandos de CLI da primeira execução

Para instalação e resolução de problemas, comece por Hermes AI Assistant — Instalação, Configuração, Fluxo de Trabalho e Resolução de Problemas.

O instalador obtém o repositório, configura um ambiente Python e liga o executável hermes. Após source ~/.bashrc ou ~/.zshrc, o seu ponto de entrada predefinido para chat interativo é simplesmente hermes (mesma família que hermes chat).

Comando Descrição
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Instalação oficial com uma linha (Linux, macOS, WSL2).
hermes / hermes chat Inicia chat interativo após a instalação (ponto de entrada diário predefinido).
hermes --version / hermes version Imprime informações de versão.
hermes completion bash | zsh | fish Emite scripts de completão de shell para tabulação.
hermes update [--check] [--backup] [--restart-gateway] Obtém o código mais recente, reinstala dependências, snapshot opcional do home antes da atualização ou reinício do gateway.
hermes uninstall [--full] [--yes] Remove o Hermes; eliminação opcional de todos os dados.

O Windows nativo não é suportado; utilize WSL2. As instalações em Android via Termux seguem um caminho dedicado na documentação upstream.

Flags globais para cada invocação do hermes

Estas flags aplicam-se antes dos subcomandos e alteram qual perfil, qual sessão ou quanta configuração pessoal carrega.

Flag Descrição
--profile, -p Seleciona o perfil do Hermes para esta execução (anula o predefinido fixo de hermes profile use).
--resume, -r Retoma uma sessão por ID ou título.
--continue [name], -c Continua a sessão mais recente, ou a mais recente que corresponde a um título.
--worktree, -w Inicia num worktree Git isolado para agentes paralelos.
--yolo Contorna os prompts de aprovação de comandos perigosos (use com cautela).
--pass-session-id Inclui o ID da sessão no prompt do sistema.
--ignore-user-config Ignora ~/.hermes/config.yaml (apenas predefinições); .env ainda é carregado.
--ignore-rules Ignora a injeção automática de AGENTS.md, SOUL.md, .cursorrules, memória, pré-carregamento de habilidades.
--tui Lança a TUI (equivalente a HERMES_TUI=1).
--dev Com --tui, executa fontes TS via tsx para desenvolvimento da TUI.

Automação isolada geralmente combina hermes chat --ignore-user-config --ignore-rules com hermes -z para execuções únicas reprodutíveis.

hermes chat, prompts de execução única e hermes -z

Comando / padrão Descrição
hermes chat Chat interativo ou scriptado; superfície principal para -q, -m, --provider, toolsets, retomar, worktree, checkpoints.
hermes chat -q "..." Num TTY, submete o prompt como o primeiro turno e permanecec na sessão. Antes da 0.21, isto terminava após uma resposta.
hermes chat --oneshot -q "..." Responde e sai (o antigo comportamento de -q). Implícito em -Q e em stdio não-TTY. Use isto quando precisar da saída das ferramentas no transcript.
hermes chat --query-file PATH Lê o prompt de um ficheiro, ou - para stdin. Nada é interpretado pela shell. Exclusivo mutuamente com -q.
hermes -z "..." Execução única scriptada — apenas a resposta final no stdout, sem banner ou ruído de sessão. Mesmo agente e ferramentas; melhor para pipes e scripts.
hermes -z "…" --usage-file PATH Após uma execução -z, escreve um relatório de utilização JSON (tokens, custo, completed / failed / partial) mesmo quando a execução falha.
hermes chat -q "…" --format stream-json Eventos JSONL no stdout (system, text, tool_use, tool_result, result). Implica modo silencioso; rejeita --tui.
hermes chat --quiet, -Q Modo programático mais silencioso (banner e prévias de ferramentas suprimidas). Também implica oneshot quando combinado com -q.
-m / --model, --provider Overrides de modelo e fornecedor por execução; env HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER espelha o comportamento.
-t / --toolsets Ativa toolsets separadas por vírgulas para a execução.
-s / --skills Pré-carrega habilidades (repetir ou separadas por vírgula).
--image path Anexa uma imagem local a uma única query.
--checkpoints Ativa checkpoints do filesystem antes de edições destrutivas.
--max-turns N Limita as iterações de chamadas de ferramentas por turno (predefinido 500, ou agent.max_turns na config).
--safe-mode Desativa config do utilizador, regras, memória, plugins, shell hooks e MCP. Implica --ignore-user-config e --ignore-rules.
--source Etiqueta de origem da sessão (cli vs tool para integrações). Execuções únicas predefinidos para oneshot.

Modelo Hermes fora da sessão vs /model dentro dela — Executar hermes model da shell é onde adiciona fornecedores, chaves e OAuth. O slash /model apenas alterna entre fornecedores já configurados. Se só vir OpenRouter em /model, saia da sessão e complete hermes model.

Códigos de saída. Uma execução de chat --oneshot / -Q sai com 0 quando o turno foi completado, 1 quando falhou, parou a meio, atingiu o orçamento de iterações ou nunca começou, e 130 em interrupção. hermes -z usa um mapa diferente: 0 completado, 2 falhado ou parcial (mesmo que tenha impresso uma explicação), 1 quando um turno completado não produziu texto, 130 em interrupção. Julgue um pipeline pelo código, não pelo facto de o stdout estar vazio.

Seletor de modelos, pools de credenciais e fornecedores de fallback

Comando Descrição
hermes model Seletor interativo de fornecedores e modelos; chaves, OAuth, endpoints personalizados.
hermes auth Pools de credenciais — add, list, remove, reset para chaves e OAuth amigáveis à rotação.
hermes fallback [list | add | remove | clear] Gerencia fornecedores de fallback ordenados quando o primário tem erros ou rate-limits.
hermes setup [model | tts | terminal | gateway | tools | agent] [...] Configuração interativa por secção ou completa (--quick, --reset, --non-interactive).
hermes setup --portal Login único no Nous Portal: OAuth, configura Nous como fornecedor de inferência, opta pelo Tool Gateway.
hermes portal [status | open | tools] Estado de autenticação do Portal e roteamento do Tool Gateway. Sem subcomando executa status.

hermes login foi removido. Use hermes auth para OAuth e pools de credenciais, hermes model para escolher um fornecedor, ou hermes setup para o assistente completo. hermes auth logout <provider> limpa um login armazenado.

Escolher endpoints locais compatíveis com OpenAI versus APIs hospedadas para hermes model assenta nos mesmos trade-offs que o geral hospedagem de LLMs (latência, custo, ops).

Uma vez que o seu predefinido termina no Qwen ou Gemma em algo como Ollama, as predefinições do sampler importam tanto quanto o ID do modelo que digitou; agregue predefinições de temperatura e penalidades orientadas a agentes em Parâmetros de inferência LLM Agentic para Qwen e Gemma.

Ficheiros de configuração e comandos hermes config

A configuração resolve-se como overrides de CLI → config.yaml → .env → predefinições. Chaves de API pertencem a .env; definições estruturadas em config.yaml.

Comando Descrição
hermes config show Mostra a configuração efetiva.
hermes config edit Abre config.yaml no $EDITOR.
hermes config set key value Define valores (secrets encaminhados para .env, não-secrets para YAML).
hermes config path / hermes config env-path Imprime os caminhos para ficheiros de config e env.
hermes config check Deteta configurações em falta ou desatualizadas.
hermes config migrate Aplica opções recém-introduzidas interativamente.

Onde os ficheiros ficam — Tudo fica sob HERMES_HOME (predefinido ~/.hermes) para config, secrets, memórias, habilidades, sessões, estado do gateway e logs.

Gestão de sessões e hermes profile

Comando Descrição
hermes sessions list Lista sessões recentes.
hermes sessions browse Seletor interativo com pesquisa e retoma.
hermes sessions export Exporta sessões (ex. JSONL).
hermes sessions delete, prune, rename, stats Apaga uma sessão, poda as antigas, renomeia títulos, mostra estatísticas do armazenamento.
hermes profile list | use | create | delete | show | rename Gerencia instâncias isoladas do Hermes numa máquina.
hermes profile export / import Arquiva ou restaura um tarball de perfil.
hermes profile alias Scripts wrappers curtos para troca rápida de perfis.
hermes worktree list Audit worktrees rascunho: idade, tamanho e se cada um é seguro para remover. --json para scripts.
hermes worktree prune Remove árvores rascunho limpas e mescladas. --dry-run imprime o plano; --older-than N apenas estreita a varredura. Árvores com trabalho não comprometido ou commits únicos são mantidas.

Use hermes -p work chat -q "..." para execuções ad hoc sem alterar o perfil predefinido fixo. Num TTY, isso permanece na sessão; adicione --oneshot quando a execução do perfil deve sair.

Hub de habilidades, toolsets, shell hooks e plugins

Para configuração com perfil prioritário e habilidades ajustadas a fluxos de trabalho reais de produção por papel, veja Hermes AI Assistant Skills for Real Production Setups. Para escrever e depurar ficheiros SKILL.md — metadados, divulgação progressiva e visibilidade condicional — veja Hermes Agent Skill Authoring — Estrutura de SKILL.md e Boas Práticas.

Comando Descrição
hermes tools Habilitação interativa de ferramentas por plataforma; --summary imprime as escolhas atuais.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Fluxos de trabalho do hub de habilidades incluindo registos e instalações por URL.
hermes curator status, run, pause, pin, rollback, … Manutenção de habilidades em segundo plano e rollback seguro.
hermes hooks list, test, revoke, doctor Shell hooks declarados e allowlists na config.
hermes plugins UI composta ou subcomandos para instalar, habilitar, desabilitar, remover plugins.

Memória embutida e provedores hermes memory

O MEMORY.md / USER.md embutidos permanecem ativos; provedores externos adicionam camadas de recall opcionais. Para saber como essa arquitetura se comporta na prática, leia Sistema de Memória do Hermes Agent — Como a Memória Persistente de IA Funciona Realmente. Para comparar backends externos e trade-offs de ativação, veja Provedores de Memória de Agentes Comparados — Honcho, Mem0, Hindsight e Mais Cinco.

Comando Descrição
hermes memory setup Configuração interativa de provedor de memória externo.
hermes memory status Mostra definições do provedor ativo.
hermes memory off Desativa o provedor externo; ficheiros embutidos permanecem.

Quando um provedor está ativo, pode registar subcomandos de topo específicos do provedor adicionais — execute hermes --help para ver o que está ligado hoje.

Gateway de mensagens, pareamento de DMs e plataformas

Comando Descrição
hermes gateway setup Configuração interativa de plataforma de mensagens.
hermes gateway run Gateway em foreground (recomendado em WSL, Docker, Termux).
hermes gateway start | stop | restart | status Controlo de serviço systemd / launchd (--all afeta o gateway de cada perfil).
hermes gateway install | uninstall Instala ou remove o serviço de segundo plano a nível de utilizador.
hermes gateway migrate [--dry-run] Funde gateways por perfil num único gateway do host. hermes update executa isto a menos que uma pré-verificação o bloqueie. Não há rollback --standalone.
hermes pairing list | approve | revoke | clear-pending Aprovações de pareamento de DMs para bots de mensagens.
hermes whatsapp Fluxo de pareamento da ponte WhatsApp.
hermes slack manifest Gera manifest de app Slack com paridade de slash no gateway.

Em WSL, hermes gateway run dentro de tmux é o padrão resiliente quando gateway start se comporta mal. Para fluxos de trabalho de telefone de ponta a ponta usando a mesma camada de gateway, veja Hermes Voice Control do Seu Telefone. Para operação em servidor dedicado com um cliente de desktop separado, siga Hermes Agent Headless Server e Configuração de Desktop Remoto.

Agendador Cron, webhooks e Kanban

Comando Descrição
hermes cron … Cria, edita, pausa, retoma, executa, remove prompts agendados (tick para passagem manual do agendador).
hermes webhook subscribe, list, remove, test Rotas dinâmicas de webhook para execuções orientadas a eventos.
hermes kanban … Quadro de tarefas multi-perfil suportado por SQLite; dispatch conduz trabalhadores.

Se precisar de padrões de concorrência práticos para hermes kanban em gateways auto-hospedados, veja Kanban no Hermes Agent para Fluxos de Trabalho LLM Auto-Hospedados.

hermes doctor, logs, backup e insights de utilização

Comando Descrição
hermes doctor [--fix] Diagnósticos interativos e reparação automática opcional.
hermes status [--all] [--deep] Estado conciso; verificações mais profundas quando necessário.
hermes dump [--show-keys] Resumo de configuração amigo de colar para problemas no Discord ou GitHub.
hermes debug share Carrega um bundle de depuração redigido para um serviço de paste (ou --local).
hermes logs [agent | errors | gateway | list] Tail e filtra logs sob o diretório de logs do perfil.
hermes backup, hermes import Snapshots zip de dados do home e caminhos de restauro.
hermes insights [--days N] [--source …] Análise de tokens, custos e atividade.

Quando algo quebra após uma atualização, hermes doctor, hermes status e hermes logs errors -f formam o loop de triagem mais rápido.

MCP, ACP, dashboard web e migração OpenClaw

Comando Descrição
hermes mcp serve Executa o Hermes como um servidor MCP.
hermes mcp add, remove, list, test, configure Gerencia conexões de cliente MCP a partir do Hermes.
hermes acp Servidor stdio do Agent Client Protocol para editores (pode aplicar instalação extra).
hermes dashboard [--port …] [--host …] Dashboard web local (pip install hermes-agent[web]).
hermes claw migrate … Migra configurações estilo OpenClaw para o Hermes (--dry-run, presets, secrets opcionais).
hermes import-agent [claude-code | codex] Importa uma configuração Claude Code (~/.claude) ou Codex CLI (~/.codex). Sempre pré-visualiza primeiro; chaves de API nunca são copiadas. --sync re-importa fontes cujos ficheiros mudaram.

Migração OpenClaw — hermes claw migrate lê diretórios home legados do OpenClaw; o cutover completo por etapas, incluindo revisão dry-run, política de conflitos, tratamento de secrets e passagem de canal, é coberto em Como Migrar do OpenClaw para o Hermes Agent com Segurança. Para o que aquela stack parecia antes de se mover, veja o estudo de caso OpenClaw.

Comandos slash na sessão CLI do Hermes

Digite / para auto-completar. Os comandos são insensíveis a maiúsculas/minúsculas; habilidades registam rotas extras /skill-name. As tabelas abaixo são um subconjunto curado; para o registo completo veja Documentação Oficial do Hermes Agent no final deste artigo.

Fluxo de sessão, tarefas em segundo plano e objetivos

Comando Descrição
/new, /reset Novo ID de sessão e histórico.
/resume [name] Retoma uma sessão nomeada.
/compress [focus] Compressão manual de contexto com tópico de foco opcional.
/retry, /undo Repete o último turno ou descarta a última troca.
/title … Nomeia a sessão para posterior /resume.
/background …, /queue …, /steer … Execução paralela em segundo plano, prompt seguinte em fila, nudge no meio do loop após a próxima ferramenta.
/goal … Objetivo persistente multi-turno com loop de juiz (status, pause, resume, clear).
/branch, /fork Ramifica a conversa para exploração alternativa.
/btw … Pergunta lateral sobre a conversa atual; não interrompe o turno principal.
/context [all] Detalhe do uso de contexto. all adiciona custos por habilidade e por toolset.
/status Informação da sessão mais um resumo local (turnos recentes, ferramentas, ficheiros). Sem chamada de modelo.
/sessions Seletor intra-sessão: filtro, setas, Enter para retomar.

Modelos, alternância de ferramentas, habilidades e recarregamento

Comando Descrição
/model … [--global] Alterna modelos entre fornecedores configurados; --global persiste o predefinido.
/tools …, /toolsets Alternadores de ferramentas da sessão e listagem de toolsets.
/skills … Pesquisa, instala e gerencia habilidades a partir do chat.
/cron … UI de tarefas agendadas a partir da sessão CLI.
/reload-mcp Recarrega servidores MCP a partir da config.
/reload Recarrega .env na sessão em execução sem reiniciar.

Utilização, ajuda e saída

Comando Descrição
/usage, /insights Visibilidade de tokens e custos; snapshot de análise.
/voice on, /voice tts Gravação de voz da CLI (Ctrl+B por predefinição) e reprodução falada.
/reasoning high Aumenta o esforço de raciocínio para a sessão.
/help, /quit Ajuda ou sair da CLI.

Uma linha que começa com ! executa na shell do host sem um turno de modelo (!git status). Não entra na conversa, e comandos perigosos ainda atingem o prompt de aprovação. Ctrl+S guarda o rascunho do compositor apenas para a sessão; nada é escrito para o disco.

As apps de mensagens (Telegram, Discord, Slack e outras) expõem um conjunto de slash sobreposto mais /approve, /restart, /commands e ajudantes de gateway relacionados — as diferenças de plataforma estão documentadas na referência de comandos slash sob Documentação Oficial do Hermes Agent abaixo.

Leitura mais útil

Páginas relacionadas neste site:

Documentação oficial do Hermes Agent

Documentação upstream em hermes-agent.nousresearch.com:

Dica. Mantenha hermes dump e hermes doctor --fix na memória muscular — eles transformam relatórios vagos de “algo quebrou” em diffs acionáveis contra uma configuração conhecida por funcionar.

Subscrever

Receba novos artigos sobre sistemas, infraestrutura e engenharia de IA.