Cola de referência do Hermes Agent CLI — comandos, sinalizadores e atalhos de barra

O Hermes Agent da Nous Research é um assistente agnóstico ao modelo, que utiliza ferramentas e 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 de longa duração para Telegram, Discord, Slack e outras plataformas de mensagens,
• hermes dashboard para uma interface web local 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 densa de comandos agrupada por tarefa.

Instalar o Hermes Agent e comandos CLI de primeira execução

Para instalação e solução de problemas, comece com Hermes AI Assistant — Install, Setup, Workflow, and Troubleshooting.

O instalador baixa o repositório, configura um ambiente Python e conecta 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]	Baixar o código mais recente, reinstalar dependências, snapshot opcional do home antes da atualização ou reinício do gateway.
hermes uninstall [--full] [--yes]	Remover o Hermes; exclusã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.

Flags globais para toda invocação do hermes

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

Flag	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 correspondente 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 o ID da sessão no prompt do sistema.
--ignore-user-config	Ignorar ~/.hermes/config.yaml (apenas padrões); .env ainda é carregado.
--ignore-rules	Ignorar auto-injeção de AGENTS.md, SOUL.md, .cursorrules, memória, skills pré-carregados.
--tui	Iniciar o TUI (equivalente a HERMES_TUI=1).
--dev	Com --tui, executar fontes TS via tsx para desenvolvimento do TUI.

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

hermes chat, prompts únicos e hermes -z

Comando / padrão	Descrição
hermes chat	Chat interativo ou scriptado; principal superfície para -q, -m, --provider, toolsets, retomada, worktree, 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 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 previews de ferramentas suprimidos).
-m / --model, --provider	Substituições de modelo e provedor por execução; env HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER espelham o comportamento.
-t / --toolsets	Habilitar toolsets separados por vírgula para a execução.
-s / --skills	Pré-carregar skills (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. A barra /model apenas alterna entre provedores já configurados. Se você só vê OpenRouter em /model, saia da sessão e complete 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]	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).

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

Escolher endpoints locais compatíveis com OpenAI versus APIs hospedadas para hermes model envolve os mesmos trade-offs da LLM hosting (latência, custo, operações).

Arquivos de configuração e comandos hermes config

A configuração é resolvida como substituições CLI → config.yaml → .env → padrões. Chaves de API pertencem ao .env; configurações estruturadas no 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 roteados para .env, não-segredos para YAML).
hermes config path / hermes config env-path	Imprimir caminhos para arquivos de configuração e env.
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, skills, 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 armazenamento.
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 skills, toolsets, shell hooks e plugins

Para configuração focada em perfil e skills ajustados para fluxos de trabalho reais de produção por função, veja Hermes AI Assistant Skills for Real Production Setups.

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 skills incluindo registros e instalações via URL.
hermes curator status, run, pause, pin, rollback, …	Manutenção de skills em segundo plano e rollback seguro.
hermes hooks list, test, revoke, doctor	Shell hooks declarados e allowlists na configuração.
hermes plugins	UI composta ou subcomandos para instalar, habilitar, desabilitar, remover plugins.

Memória embutida e provedores hermes memory

Os arquivos embutidos MEMORY.md / USER.md permanecem ativos; provedores externos adicionam camadas de recuperação opcionais. Para entender como essa arquitetura se comporta na prática, leia Hermes Agent Memory System — How Persistent AI Memory Actually Works. Para comparar backends externos e trade-offs de ativação, veja Agent Memory Providers Compared — Honcho, Mem0, Hindsight, and Five More.

Comando	Descrição
hermes memory setup	Configuração interativa de provedor de memória externa.
hermes memory status	Mostrar configurações de provedor ativo.
hermes memory off	Desativar provedor externo; arquivos embutidos permanecem.

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

Gateway de mensagens, pareamento 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 pareamento DM para bots de mensagens.
hermes whatsapp	Fluxo de pareamento de ponte WhatsApp.
hermes slack manifest	Gerar manifesto de app Slack com paridade de slash do gateway.

No WSL, hermes gateway run dentro do tmux é o padrão resiliente quando gateway start apresenta problemas.

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 suportado por SQLite; dispatch dirige workers.

hermes doctor, logs, backup e insights de uso

Comando	Descrição
hermes doctor [--fix]	Diagnóstico interativo 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 para issues no Discord ou GitHub.
hermes debug share	Fazer upload de bundle de debug anonimizado 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 restaurar caminhos.
hermes insights [--days N] [--source …]	Analytics 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	Executar Hermes como servidor MCP.
hermes mcp add, remove, list, test, configure	Gerenciar conexões de cliente MCP do Hermes.
hermes acp	Servidor stdio do Agent Client Protocol 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 configurações estilo OpenClaw para o Hermes (--dry-run, presets, segredos opcionais).

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

Comandos slash na sessão CLI do Hermes

Digite / para autocompletar. Comandos são insensíveis a maiúsculas/minúsculas; skills registram rotas extras /skill-name. As tabelas abaixo são um subconjunto selecionado; para o registro 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]	Retomar uma sessão nomeada.
/compress [focus]	Compressão manual de contexto com tópico de foco opcional.
/retry, /undo	Retentar último turno ou descartar última troca.
/title …	Nomear a sessão para /resume posterior.
/background …, /queue …, /steer …	Execução em segundo plano paralela, próximo prompt enfileirado, ajuste de meio de 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 alternada.

Modelos, toggles de ferramentas, skills 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 toolsets.
/skills …	Buscar, instalar e gerenciar skills 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 reiniciar.

Uso, ajuda e saída

Comando	Descrição
/usage, /insights	Visibilidade de tokens e custos; snapshot de analytics.
/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 sob Documentação Oficial do Hermes Agent abaixo.

Leitura mais útil

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

• AI Systems — Self-Hosted Assistants, RAG, and Local Infrastructure — visão geral do cluster e como assistentes se encaixam no stack
• AI Systems Memory — hub de memória e guias adjacentes
• AI Developer Tools — panorama de ferramentas de terminal e IDE
• OpenCode Quickstart — 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
• CLI commands reference
• Slash commands reference

---

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.