Resumo de atalhos do Hermes Agent CLI — comandos, sinalizadores e atalhos de barra

O Hermes Agent da Nous Research é um assistente agnóstico ao modelo e utilizador de ferramentas que você executa localmente ou em um VPS.

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

• o CLI clássico hermes / hermes chat,
• 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,
• o hermes dashboard para uma interface de usuário local no navegador quando o extra web estiver instalado.

Esses caminhos compartilham a mesma configuração e dados em ~/.hermes; esta página lista os comandos de shell relevantes para todos esses modos.

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

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

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

O instalador baixa o repositório, configura um ambiente Python e integra o executável hermes. Após executar source ~/.bashrc ou ~/.zshrc, seu ponto de entrada padrão para chat interativo é simplesmente hermes (mesma família de 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	Iniciar chat interativo após a instalação (entrada diária padrão).
hermes --version / hermes version	Exibir informações de versão.
hermes completion bash | zsh | fish	Emitir scripts de conclusão de shell para tabulação.
hermes update [--check] [--backup] [--restart-gateway]	Obter o código mais recente, reinstalar dependências, snapshot opcional do diretório home antes da atualização ou reinício do gateway.
hermes uninstall [--full] [--yes]	Remover o Hermes; deleção opcional de todos os dados.

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

Bandeiras globais para cada invocação de hermes

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

Bandeira	Descrição
--profile, -p	Selecionar perfil do Hermes para esta execução (sobrescreve o padrão fixo de hermes profile use).
--resume, -r	Retomar uma sessão por ID ou título.
--continue [name], -c	Continuar a sessão mais recente, ou a mais recente que corresponda a um título.
--worktree, -w	Iniciar em uma worktree Git isolada para agentes paralelos.
--yolo	Ignorar prompts de aprovação de comandos perigosos (use com cuidado).
--pass-session-id	Incluir ID da sessão no prompt do sistema.
--ignore-user-config	Ignorar ~/.hermes/config.yaml (apenas padrões); .env ainda é carregado.
--ignore-rules	Ignorar injeção automática de AGENTS.md, SOUL.md, .cursorrules, memória e habilidades pré-carregadas.
--tui	Lançar a TUI (equivalente a HERMES_TUI=1).
--dev	Com --tui, executar 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 reproduzíveis.

hermes chat, prompts únicos e hermes -z

Comando / padrão	Descrição
hermes chat	Chat interativo ou scriptado; superfície principal para -q, -m, --provider, conjuntos de ferramentas, retomada, worktree e checkpoints.
hermes chat -q "..."	Prompt único (não interativo); mantém saída mais rica que -z quando ferramentas são executadas.
hermes -z "..."	Execução única scriptada — apenas a resposta final no stdout, sem banner ou ruído de sessão. Mesmo agente e ferramentas; ideal para pipes e scripts.
hermes chat --quiet, -Q	Modo programático mais silencioso (banner e prévias de ferramentas suprimidos).
-m / --model, --provider	Sobrescritas de modelo e provedor por execução; as variáveis de ambiente HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER espelham esse comportamento.
-t / --toolsets	Habilitar conjuntos de ferramentas separados por vírgula para a execução.
-s / --skills	Pré-carregar habilidades (repetir ou separar por vírgula).
--image path	Anexar uma imagem local a uma única consulta.
--checkpoints	Habilitar checkpoints no sistema de arquivos antes de edições destrutivas.
--max-turns N	Limitar iterações de chamada 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 comando /model apenas alterna entre provedores já configurados. Se você só vê OpenRouter em /model, saia da sessão e conclua hermes model.

Seletor de modelos, pools de credenciais e provedores de fallback

Comando	Descrição
hermes model	Seletor interativo de provedores 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]	Gerenciar provedores de fallback ordenados quando o primário falha ou limita taxa.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configuração interativa seccionada ou completa (--quick, --reset, --non-interactive).

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

Escolher endpoints compatíveis com OpenAI locais versus APIs hospedadas para hermes model envolve as mesmas compensações que o hospedagem de LLMs (latência, custo, operações).

Uma vez que seu padrão termina no Qwen ou Gemma em algo como Ollama, os padrões do sampler são tão importantes quanto o ID do modelo digitado; consulte os presets de temperatura e penalidade orientados a agentes em Parâmetros de inferência agentic para Qwen e Gemma.

Arquivos de configuração e comandos hermes config

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

Comando	Descrição
hermes config show	Exibir configuração efetiva.
hermes config edit	Abrir config.yaml no $EDITOR.
hermes config set key value	Definir valores (segredos rotacionados para .env, não-segredos para YAML).
hermes config path / hermes config env-path	Imprimir caminhos para arquivos de configuração e ambiente.
hermes config check	Detectar configurações faltantes ou obsoletas.
hermes config migrate	Aplicar novas opções interativamente.

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

Gerenciamento de sessões e hermes profile

Comando	Descrição
hermes sessions list	Listar sessões recentes.
hermes sessions browse	Seletor interativo com busca e retomada.
hermes sessions export	Exportar sessões (ex. JSONL).
hermes sessions delete, prune, rename, stats	Excluir uma sessão, podar antigas, renomear títulos, mostrar estatísticas do repositório.
hermes profile list | use | create | delete | show | rename	Gerenciar instâncias Hermes isoladas em uma máquina.
hermes profile export / import	Arquivar ou restaurar um tarball de perfil.
hermes profile alias	Scripts wrapper curtos para troca rápida de perfis.

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

Hub de habilidades, conjuntos de ferramentas, hooks de shell e plugins

Para configuração focada em perfil e habilidades ajustadas a fluxos de trabalho de produção reais por função, veja Habilidades do Assistente Hermes AI para Configurações de Produção Reais. Para escrever e depurar arquivos SKILL.md — metadados, disclosure progressivo e visibilidade condicional — veja Autoria de Habilidades do Hermes Agent — Estrutura e Melhores Práticas do 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 de trabalho do hub de habilidades incluindo registros 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	Hooks de shell declarados e listas de permissão na configuração.
hermes plugins	UI composta ou subcomandos para instalar, habilitar, desabilitar, remover plugins.

Memória nativa e provedores hermes memory

Os arquivos nativos MEMORY.md / USER.md permanecem ativos; provedores externos adicionam camadas de recall opcionais. Para entender 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 compensações 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 provedores de memória externa.
hermes memory status	Mostrar configurações de provedor ativo.
hermes memory off	Desativar provedor externo; arquivos nativos permanecem.

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

Gateway de mensagens, emparelhamento DM e plataformas

Comando	Descrição
hermes gateway setup	Configuração interativa de plataforma de mensagens.
hermes gateway run	Gateway em primeiro plano (recomendado no WSL, Docker, Termux).
hermes gateway start | stop | restart | status	Controle de serviço systemd / launchd (--all afeta o gateway de todos os perfis).
hermes gateway install | uninstall	Instalar ou remover serviço de fundo de nível de usuário.
hermes pairing list | approve | revoke | clear-pending	Aprovações de emparelhamento DM para bots de mensagens.
hermes whatsapp	Fluxo de emparelhamento de ponte WhatsApp.
hermes slack manifest	Gerar manifesto do app Slack com paridade de slash do gateway.

No WSL, hermes gateway run dentro do tmux é o padrão resiliente quando gateway start falha. Para fluxos de trabalho de telefone ponta a ponta usando essa mesma camada de gateway, veja Controle de Voz do Hermes do Seu Telefone. Para operação em servidor dedicado com cliente desktop separado, siga Configuração de Servidor Headless e Área de Trabalho Remota do Hermes Agent.

Agendador Cron, webhooks e Kanban

Comando	Descrição
hermes cron …	Criar, editar, pausar, retomar, executar, remover prompts agendados (tick para passagem manual do agendador).
hermes webhook subscribe, list, remove, test	Rotas de webhook dinâmicas para execuções orientadas a eventos.
hermes kanban …	Quadro de tarefas multi-perfil apoiado por SQLite; dispatch aciona 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 LLMs 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 paste em issues do Discord ou GitHub.
hermes debug share	Upload de pacote de debug anonimizadado para um serviço de paste (ou --local).
hermes logs [agent | errors | gateway | list]	Tail e filtrar logs no diretório de logs do perfil.
hermes backup, hermes import	Snapshots zip dos dados home e restauração de caminhos.
hermes insights [--days N] [--source …]	Analítica 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 do OpenClaw

Comando	Descrição
hermes mcp serve	Executar o Hermes como um servidor MCP.
hermes mcp add, remove, list, test, configure	Gerenciar conexões de cliente MCP do Hermes.
hermes acp	Servidor stdio do Protocolo do Cliente do Agente para editores (instalação extra pode ser necessária).
hermes dashboard [--port …] [--host …]	Dashboard web local (pip install hermes-agent[web]).
hermes claw migrate …	Migrar configs estilo OpenClaw para o Hermes (--dry-run, presets, segredos opcionais).

Migração do OpenClaw — hermes claw migrate lê diretórios home legados do OpenClaw; para ver como esse stack era antes da mudança, veja o estudo de caso do OpenClaw.

Comandos slash na sessão do CLI do Hermes

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

Fluxo de sessão, tarefas de fundo e objetivos

Comando	Descrição
/new, /reset	Novo ID de sessão e histórico.
/resume [name]	Retomar uma sessão nomeada.
/compress [focus]	Compressão manual de contexto com tópico de foco opcional.
/retry, /undo	Repetir último turno ou descartar última troca.
/title …	Nomear a sessão para /resume posterior.
/background …, /queue …, /steer …	Execução paralela em segundo plano, próximo prompt na fila, ajuste mid-loop após próxima ferramenta.
/goal …	Objetivo persistente multi-turno com loop de juiz (status, pause, resume, clear).
/branch, /fork	Ramificar a conversa para exploração alternativa.

Modelos, toggles de ferramentas, habilidades e recarregar

Comando	Descrição
/model … [--global]	Alternar modelos entre provedores configurados; --global persiste o padrão.
/tools …, /toolsets	Toggles de ferramentas de sessão e listagem de conjuntos de ferramentas.
/skills …	Buscar, instalar e gerenciar habilidades do chat.
/cron …	UI de tarefas agendadas da sessão CLI.
/reload-mcp	Recarregar servidores MCP da configuração.
/reload	Recarregar .env na sessão em execução sem reinício.

Uso, ajuda e sair

Comando	Descrição
/usage, /insights	Visibilidade de tokens e custos; snapshot analítico.
/help, /quit	Ajuda ou sair do CLI.

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

Leitura adicional útil

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

• Sistemas de IA — Assistentes Auto-Hospedados, RAG e Infraestrutura Local — visão geral do cluster e como os assistentes se encaixam na stack
• Memória de Sistemas de IA — hub de memória e guias adjacentes
• Ferramentas de Desenvolvimento para IA — panorama de ferramentas de terminal e IDE
• Início Rápido do OpenCode — outro agente focado em 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 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.