Folha de consulta do Hermes Agent CLI — comandos, flags e atalhos de barra

O Hermes Agent da Nous Research é um assistente agnóstico de modelo que utiliza ferramentas e pode ser executado localmente ou em uma VPS.

O Hermes não o prende a uma única interface. Você pode usar:

• o hermes / hermes chat clássico via CLI,
• a sessão em tela cheia hermes --tui,
• um hermes gateway em execução contínua para Telegram, Discord, Slack e outras plataformas de mensagens,
• hermes dashboard para uma interface do navegador local quando o extra web está instalado.

Esses caminhos compartilham a mesma configuração e dados sob ~/.hermes; esta página lista os comandos de shell que importam entre esses modos.

Abaixo está uma referência densa de comandos agrupada por tarefa.

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

Para instalação e solução de problemas, comece com Assistente Hermes AI — Instalação, Configuração, Fluxo de Trabalho e Solução de Problemas.

O instalador obtém o repositório, configura um ambiente Python e conecta o executável hermes. Após source ~/.bashrc ou ~/.zshrc, seu ponto de entrada padrão 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 em uma linha (Linux, macOS, WSL2).
hermes / hermes chat	Inicia o chat interativo após a instalação (entrada padrão diária).
hermes --version / hermes version	Imprime informações de versão.
hermes completion bash | zsh | fish	Emite scripts de conclusão de shell para conclusão de tabulação.
hermes update [--check] [--backup] [--restart-gateway]	Obtém o código mais recente, reinstala dependências, snapshot opcional do home pré-atualização ou reinício do gateway.
hermes uninstall [--full] [--yes]	Remove o Hermes; exclusão opcional de dados completos.

Windows nativo não é suportado; use WSL2. Instalações Android via Termux seguem um caminho dedicado na documentação upstream.

Flags globais para cada invocação do hermes

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

Flag	Descrição
--profile, -p	Seleciona o perfil Hermes para esta execução (sobrepõe o padrão fixo do 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 correspondente a um título.
--worktree, -w	Inicia em uma worktree Git isolada para agentes paralelos.
--yolo	Ignora prompts de aprovação de comandos perigosos (use com cuidado).
--pass-session-id	Inclui o ID da sessão no prompt do sistema.
--ignore-user-config	Pula ~/.hermes/config.yaml (apenas padrões); o .env ainda é carregado.
--ignore-rules	Pula a injeção automática de AGENTS.md, SOUL.md, .cursorrules, memória, habilidades pré-carregadas.
--tui	Inicia a TUI (equivalente a HERMES_TUI=1).
--dev	Com --tui, executa fontes TS via tsx para desenvolvimento da TUI.

Automação isolada muitas vezes combina hermes chat --ignore-user-config --ignore-rules com hermes -z para um-shots reproduzíveis.

hermes chat, prompts de um-shots 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 "..."	Prompt de um-shot (não interativo); mantém saída mais rica que -z quando ferramentas rodam.
hermes -z "..."	Um-shot scriptado — apenas a resposta final no stdout, sem banner ou ruído de sessão. Mesmo agente e ferramentas; melhor para pipes e scripts.
hermes chat --quiet, -Q	Modo programático mais silencioso (banner e pré-visualizações de ferramentas suprimidas).
-m / --model, --provider	Sobrescritas de modelo e provedor por execução; env HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER espelham o comportamento.
-t / --toolsets	Habilita toolsets separados por vírgula para a execução.
-s / --skills	Pré-carrega habilidades (repita ou separe por vírgula).
--image path	Anexa uma imagem local a uma única consulta.
--checkpoints	Habilita checkpoints de sistema de arquivos antes de edições destrutivas.
--max-turns N	Limita iterações de chamadas de ferramentas por turno (padrão da configuração).
--source	Tag de origem da sessão (cli vs tool para integrações).

Modelo Hermes fora da sessão vs /model dentro dela — Executar hermes model do shell é onde você adiciona provedores, chaves e OAuth. O slash /model apenas alterna entre provedores já configurados. Se você só vê OpenRouter no /model, saia da sessão e conclua hermes model.

Seletor de modelo, pools de credenciais e provedores de fallback

Comando	Descrição
hermes model	Seletor interativo de provedor e modelo; chaves, OAuth, endpoints personalizados.
hermes auth	Pools de credenciais — add, list, remove, reset para chaves amigáveis à rotação e OAuth.
hermes fallback [list | add | remove | clear]	Gerencia provedores de fallback ordenados quando o primário dá erro ou rate-limits.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configuração interativa seccionada ou completa (--quick, --reset, --non-interactive).

hermes login / hermes logout obsoletos — use hermes auth e hermes model em vez disso.

Escolher endpoints locais compatíveis com OpenAI versus APIs hospedadas para hermes model se situa nos mesmos trade-offs do Hospedagem de LLM (latência, custo, operações).

Uma vez que seu padrão termina em Qwen ou Gemma em algo como Ollama, os padrões de sampler importam tanto quanto qual ID de modelo você digitou; agregue presets de temperatura e penalidade orientados a agentes em Parâmetros de inferência LLM agêntica para Qwen e Gemma.

Arquivos de configuração e comandos hermes config

A configuração se resolve como sobrescritas de CLI → config.yaml → .env → padrões. Chaves de API pertencem em .env; configurações estruturadas em config.yaml.

Comando	Descrição
hermes config show	Exibe a configuração efetiva.
hermes config edit	Abre config.yaml em $EDITOR.
hermes config set key value	Define valores (segredos roteados para .env, não-segredos para YAML).
hermes config path / hermes config env-path	Imprime caminhos para arquivos de config e env.
hermes config check	Detecta configurações ausentes ou obsoletas.
hermes config migrate	Aplica opções recém-introduzidas interativamente.

Onde os arquivos ficam — Tudo fica sob HERMES_HOME (padrão ~/.hermes) para config, segredos, memórias, habilidades, sessões, estado do gateway e logs.

Gerenciamento de sessões e hermes profile

Comando	Descrição
hermes sessions list	Lista sessões recentes.
hermes sessions browse	Seletor interativo com busca e retomar.
hermes sessions export	Exporta sessões (ex. JSONL).
hermes sessions delete, prune, rename, stats	Exclui uma sessão, poda antigas, renomeia títulos, mostra estatísticas do armazenamento.
hermes profile list | use | create | delete | show | rename	Gerencia instâncias Hermes isoladas em uma máquina.
hermes profile export / import	Arquivar ou restaurar um tarball de perfil.
hermes profile alias	Scripts de wrapper curtos para troca rápida de perfil.

Use hermes -p work chat -q "..." para execuções ad hoc sem alterar o perfil padrão fixo.

Hub de habilidades, toolsets, shell hooks e plugins

Para configuração com perfil primeiro e habilidades ajustadas a fluxos de trabalho reais de produção por papel, veja Habilidades do Assistente Hermes AI para Configurações Reais de Produção. Para escrever e depurar arquivos SKILL.md — metadados, divulgação progressiva e visibilidade condicional — veja Criação de Habilidade do Hermes Agent — Estrutura e Boas Práticas de SKILL.md.

Comando	Descrição
hermes tools	Habilitação interativa de ferramentas por plataforma; --summary imprime escolhas atuais.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Fluxos do hub de habilidades incluindo registries 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 listas de permissão em config.
hermes plugins	UI composada ou subcomandos para instalar, habilitar, desabilitar, remover plugins.

Memória embutida e provedores hermes memory

Arquivos embutidos MEMORY.md / USER.md permanecem ativos; provedores externos adicionam camadas opcionais de recall. Para como essa arquitetura se comporta na prática, leia Sistema de Memória do Hermes Agent — Como a Memória Persistente de IA Realmente Funciona. 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 externo de memória.
hermes memory status	Mostra configurações de provedor ativo.
hermes memory off	Desabilita provedor externo; arquivos embutidos permanecem.

Quando um provedor está ativo, pode registrar subcomandos extras de nível superior específicos do provedor — execute hermes --help para ver o que está conectado hoje.

Gateway de mensagens, pareamento de DM e plataformas

Comando	Descrição
hermes gateway setup	Configuração interativa de plataforma de mensagens.
hermes gateway run	Gateway em primeiro plano (recomendado em WSL, Docker, Termux).
hermes gateway start | stop | restart | status	Controle de serviço systemd / launchd (--all afeta o gateway de cada perfil).
hermes gateway install | uninstall	Instala ou remove serviço de segundo plano de nível de usuário.
hermes pairing list | approve | revoke | clear-pending	Aprovações de pareamento de DM para bots de mensagens.
hermes whatsapp	Fluxo de pareamento de bridge WhatsApp.
hermes slack manifest	Gera manifest do app Slack com paridade de slash 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 ponta a ponta usando aquela mesma camada de gateway, veja Controle por Voz Hermes do Seu Telefone. Para operação em servidor dedicado com um cliente de desktop separado, siga Configuração de Servidor Headless e Desktop Remoto do Hermes Agent.

Agendador Cron, webhooks e Kanban

Comando	Descrição
hermes cron …	Cria, edita, pausa, retoma, executa, remove prompts agendados (tick para passo 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 dirige workers.

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

hermes doctor, logs, backup e insights de uso

Comando	Descrição
hermes doctor [--fix]	Diagnósticos interativos e reparo automático opcional.
hermes status [--all] [--deep]	Status conciso; verificações mais profundas quando necessário.
hermes dump [--show-keys]	Resumo de configuração amigável para colar em issues do Discord ou GitHub.
hermes debug share	Envia bundle de depuração redigido para um serviço de paste (ou --local).
hermes logs [agent | errors | gateway | list]	Cola e filtra logs sob o diretório de log do perfil.
hermes backup, hermes import	Snapshots zip dos dados home e caminhos de restauração.
hermes insights [--days N] [--source …]	Analytics de token, custo 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 do Hermes.
hermes acp	Servidor stdio do Agent Client Protocol para editores (instalação extra pode aplicar).
hermes dashboard [--port …] [--host …]	Dashboard web local (pip install hermes-agent[web]).
hermes claw migrate …	Migra configs estilo OpenClaw para o Hermes (--dry-run, presets, segredos opcionais).

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 conflito, tratamento de segredos e transferência de canal, é coberto em Como Migrar do OpenClaw para o Hermes Agent com Segurança. Para como aquela pilha parecia antes da mudança, veja o estudo de caso OpenClaw.

Comandos slash na sessão da CLI do Hermes

Digite / para auto-completar. Os comandos são insensíveis a maiúsculas/minúsculas; habilidades registram rotas extras de /skill-name. As tabelas abaixo são um subconjunto curado; para o registry completo veja a 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	Tenta o último turno novamente ou descarta a última troca.
/title …	Nomeia a sessão para /resume posterior.
/background …, /queue …, /steer …	Execução em segundo plano paralela, próximo prompt em fila, toque 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.

Modelos, alternância de ferramentas, habilidades e recarregar

Comando	Descrição
/model … [--global]	Alterna modelos entre provedores configurados; --global persiste padrão.
/tools …, /toolsets	Alternância de ferramentas de sessão e listagem de toolsets.
/skills …	Busca, instala e gerencia habilidades do chat.
/cron …	UI de tarefas agendadas da sessão da CLI.
/reload-mcp	Recarrega servidores MCP da configuração.
/reload	Recarrega .env na sessão em execução sem reinício.

Uso, ajuda e saída

Comando	Descrição
/usage, /insights	Visibilidade de token e custo; snapshot de analytics.
/help, /quit	Ajuda ou sai da CLI.

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

Leitura mais útil

Páginas relacionadas neste site (contexto mais amplo para Hermes e agentes de terminal):

• Sistemas de IA — Assistentes Auto-Hospedados, RAG e Infraestrutura Local — visão geral do cluster e como assistentes se encaixam na pilha
• Memória de Sistemas de IA — hub de memória e guias adjacentes
• Ferramentas de Desenvolvimento de IA — panorama de ferramentas de terminal e IDE
• Início Rápido OpenCode — outro agente centrado no terminal para comparação ergonômica

Documentação Oficial do Hermes Agent

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

• Hermes Agent
• Referência de comandos da CLI
• Referência de comandos slash

---

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 como boa.