Referência de Comandos de Barra

Referência de Comandos de Barra

O Hermes tem duas superfícies de comando de barra, as duas movidas por um COMMAND_REGISTRY central em hermes_cli/commands.py:

• Comandos de barra da CLI interativa — despachados por cli.py, com autocompletar vindo do registro
• Comandos de barra de mensagens — despachados por gateway/run.py, com texto de ajuda e menus de plataforma gerados a partir do registro

As skills instaladas também aparecem como comandos de barra dinâmicos nas duas superfícies. Isso inclui skills que já vêm junto, como a /plan, que abre o modo de plano e salva planos em markdown sob .hermes/plans/, relativo ao espaço de trabalho / diretório de trabalho do backend ativo.

Permissões e divisão entre administrador e usuário

Toda plataforma de mensagens que aceita uma lista de permitidos por usuário (Telegram, Discord, Slack, Matrix, Mattermost, Signal, …) também aceita uma divisão de comandos de barra em dois níveis: administradores recebem todo comando registrado, usuários comuns recebem só os nomes que você lista em user_allowed_commands (mais o piso sempre permitido, /help e /whoami). Configure allow_admin_from e user_allowed_commands (e os equivalentes por grupo, group_allow_admin_from / group_user_allowed_commands) dentro do bloco extra: da plataforma, em ~/.hermes/gateway-config.yaml.

Veja a documentação de cada plataforma para exemplos — a estrutura é idêntica em todas:

• Telegram
• Discord
• Slack
• Matrix
• Mattermost
• Signal

Se allow_admin_from não está definido para um escopo, aquele escopo continua no modo irrestrito de compatibilidade retroativa — todo usuário permitido pode rodar todo comando.

Comandos de barra da CLI interativa

Digite / na CLI para abrir o menu de autocompletar. Os comandos embutidos não diferenciam maiúsculas de minúsculas.

Sessão

Comando	Descrição
/new [nome] (apelido: /reset)	Começa uma sessão nova (ID de sessão e histórico zerados). O [nome] opcional define o título inicial da sessão — por exemplo, /new meu-experimento abre uma sessão nova já com o título meu-experimento, o que facilita encontrar depois com /resume ou /sessions. Acrescente now, --yes ou -y para pular a janela de confirmação — por exemplo, /reset now, /new --yes meu-experimento.
/clear	Limpa a tela e começa uma sessão nova
/history	Mostra o histórico da conversa (respeita o /timestamps)
/save	Salva a conversa atual
/prompt (apelido: /compose)	Escreve seu próximo prompt no $EDITOR (markdown) em vez do campo embutido — útil para prompts longos, de várias linhas ou formatados com cuidado.
/retry	Tenta a última mensagem de novo (reenvia ao agente)
/undo	Remove a última troca entre usuário e assistente
/title	Define um título para a sessão atual (uso: /title Nome da Minha Sessão)
/compress [here [N] | focus tópico]	Compacta manualmente o contexto da conversa (descarrega memórias + resume). O /compress here [N] resume tudo, menos as N trocas mais recentes (padrão 2), mantidas na íntegra — escolha sua própria fronteira de compactação. Um tópico de foco restringe o que um resumo completo preserva.
/rollback	Lista ou restaura checkpoints do sistema de arquivos (uso: /rollback [número])
/diff [staged|all|session] [--stat] [caminho...]	Mostra as mudanças do git no diretório de trabalho. Padrão: mudanças não preparadas mais os arquivos não rastreados. O staged mostra o que está preparado para commit, o all mostra tudo desde o HEAD, e o session mostra o diff acumulado de tudo que o Hermes mudou aqui (a partir da linha de base do checkpoint retido mais antigo — exige checkpoints habilitados; complementa o /rollback diff <N>). O --stat imprime só o resumo de arquivos alterados; argumentos de caminho restringem o diff.
/snapshot [create|restore <id>|prune] (apelido: /snap)	Cria ou restaura snapshots de estado da configuração/estado do Hermes. O create [rótulo] salva um snapshot, o restore <id> volta para ele, o prune [N] remove snapshots antigos, ou liste todos sem argumentos. As restaurações de banco de dados escrevem pela API de backup do SQLite, para que os processos ativos (gateway, painel) vejam os dados restaurados com segurança; se esse caminho falha enquanto outro processo ainda mantém o banco aberto, a restauração recusa em vez de arriscar corromper — pare o processo que segura o banco e tente de novo.
/stop	Mata todos os processos em segundo plano que estão rodando
/queue <prompt> (apelido: /q)	Coloca um prompt na fila para o próximo turno (não interrompe a resposta atual do agente).
/steer <prompt>	Injeta uma nota no meio da execução, que chega ao agente depois da próxima chamada de ferramenta — sem interrupção, sem novo turno de usuário. O texto é anexado ao conteúdo do último resultado de ferramenta assim que a ferramenta atual termina, dando contexto novo ao agente sem quebrar o laço de chamadas de ferramenta em curso. Use isso para ajustar o rumo no meio da tarefa (por exemplo, "foque no módulo de autenticação" enquanto o agente roda os testes).
/goal <texto>	Define uma meta permanente na direção da qual o Hermes trabalha ao longo dos turnos — a nossa versão do laço Ralph. Depois de cada turno, um modelo juiz auxiliar decide se a meta foi cumprida; se não, o Hermes continua sozinho. Subcomandos: /goal status, /goal pause, /goal resume, /goal clear. O orçamento padrão é de 20 turnos (goals.max_turns); qualquer mensagem real de usuário toma a frente do laço de continuação, e o estado sobrevive ao /resume. Veja Metas persistentes para o passo a passo completo.
/subgoal <texto>	Acrescenta um critério fornecido por você à meta ativa, no meio do laço. O prompt de continuação apresenta todos os submetas ao agente na íntegra, e o juiz leva elas em conta no veredito DONE/CONTINUE — então a meta não é dada como cumprida até que a meta original e cada submeta sejam atendidas. Subcomandos: /subgoal (lista), /subgoal remove <N>, /subgoal clear. Exige um /goal ativo.
/heartbeat every <intervalo> <prompt> (apelido: /hb)	Define um prompt recorrente que volta a entrar nesta sessão como um turno normal de usuário sempre que ela está ociosa e o intervalo já passou (mínimo de 60s; batidas perdidas se fundem numa só). Subcomandos: /heartbeat status, /heartbeat pause, /heartbeat resume, /heartbeat clear. Tem escopo de sessão e roda no processo — use o hermes cron para agendamentos duráveis e isolados. Veja Heartbeats de sessão.
/refine [foco]	Roda agora a revisão de automelhoria de memória/skills em segundo plano, em vez de esperar o disparo automático de fim de turno. O texto de foco opcional guia a revisão (por exemplo, /refine salve o fluxo de deploy como skill). Roda num fork em segundo plano contra um snapshot da conversa — a sessão ativa e o cache de prompt não são tocados; os resultados são informados quando termina.
/review [instruções]	Cria um subagente revisor independente e com privilégios completos para revisar o trabalho que acabou de ser discutido — um PR, código, documentação, qualquer artefato citado nas últimas 10 mensagens do chat. Ele investiga em segundo plano (abre o PR, lê o diff, roda código) e a revisão completa dele volta a entrar nesta sessão como uma conclusão de subagente em segundo plano, com a qual o agente principal pode trabalhar. Fixe um modelo dedicado de revisão pelo auxiliary.review no config.yaml (por padrão, o seu modelo principal). Veja Delegação para subagentes.
/moa <prompt>	Roda um único prompt pelo preset padrão de Mistura de Agentes e depois restaura o seu modelo atual. É de tiro único — não muda o modelo da sua sessão.
/resume [nome]	Retoma uma sessão nomeada anteriormente
/sessions (apelido na TUI: /switch)	CLI clássica: navega e retoma sessões anteriores num seletor interativo. TUI: abre o alternador de sessões ao vivo para as sessões de TUI abertas no momento. Use /sessions new na TUI para começar outra sessão ao vivo na hora.
/egress [status]	Mostra o status do proxy de saída do Docker — estado de habilitado/configurado/rodando, origem das credenciais, mapeamentos de token, provedores não cobertos e o próximo passo de correção. Funciona na CLI, na TUI, no chat do Desktop e no gateway de mensagens.
/redraw	Força um redesenho completo da interface (recupera de desvios do terminal depois de redimensionar no tmux, de artefatos de seleção com o mouse, etc.)
/status	Mostra informação da sessão — modelo, provedor, perfil, ID de sessão, diretório de trabalho, título, datas de criação/atualização, totais de token, estado de agente em execução —, seguida de um bloco local de Resumo da sessão (contagens recentes de turnos de usuário/assistente, contagem de resultados de ferramenta, ferramentas mais usadas, últimos arquivos tocados, o prompt mais recente do usuário e a resposta mais recente do assistente). O resumo é calculado localmente a partir da conversa em memória; sem chamada de LLM, sem impacto no cache de prompt.
/context [all] (apelido: /ctx)	Detalhamento visual da janela de contexto. Na CLI/TUI: uma grade de glifos de 5×20 (cada célula ≈ 1% da janela do modelo) mais uma tabela estimada por categoria — prompt de sistema, definições de ferramenta, regras, índice de skills, MCP, subagentes, memória, conversa — contra o espaço livre. Nas plataformas de mensagens: um medidor de uso com limiar/folga de compactação automática, estatísticas de compactação, vazão acumulada e a mesma tabela de categorias em texto puro. O /context all acrescenta as listagens de custo por skill e por conjunto de ferramentas (custo de índice x custo de carregar o SKILL.md; tokens de esquema por conjunto de ferramentas). É somente leitura e calculado localmente — sem chamada de LLM, sem impacto no cache de prompt.
/agents (apelido: /tasks)	Mostra os agentes ativos e as tarefas em execução na sessão atual.
/background <prompt> (apelidos: /bg, /btw)	Roda um prompt numa sessão separada em segundo plano. O agente processa seu prompt de forma independente — sua sessão atual fica livre para outro trabalho. Os resultados aparecem num painel quando a tarefa termina. Veja Sessões em segundo plano na CLI.
/branch [nome] (apelido: /fork)	Ramifica a sessão atual (para explorar um caminho diferente)
/worktree [new [nome]|list]	Só na CLI. Inspeciona ou cria worktrees isoladas do git no meio da sessão (inspirado no /worktree new do Copilot CLI). O /worktree puro mostra a worktree ativa; o /worktree list lista as worktrees do repositório; o /worktree new [nome] cria uma worktree sob .worktrees/ (ramificada da ponta remota recém-buscada, respeitando o worktree_sync) e redireciona o terminal e as ferramentas de arquivo da sessão para dentro dela. Árvores nomeadas usam o seu nome (branch hermes/<nome>); as sem nome ganham um hermes-<id> aleatório. Na saída, a árvore só é mantida se tiver commits não enviados — mesmo ciclo de vida do hermes -w. Veja Git Worktrees.
/handoff <plataforma>	Só na CLI. Passa a sessão atual para uma plataforma de mensagens (Telegram, Discord, Slack, WhatsApp, Signal, Matrix). O gateway assume na hora, cria uma thread nova nas plataformas que têm thread (tópicos do Telegram, threads de canal de texto do Discord, threads ancoradas em mensagem no Slack), religa o destino ao session_id da sua CLI para a transcrição completa e ciente de papéis ser reproduzida, e forja um turno sintético de usuário para o agente confirmar que está trabalhando no lugar novo. Sua CLI encerra limpo em caso de sucesso, com uma dica de /resume; retome localmente quando quiser com /resume <título>. Recusado no meio de um turno. Exige o gateway rodando e um canal principal configurado para a plataforma de destino (/sethome a partir do chat de destino). Veja Passagem entre plataformas.
/journey [list|delete <id>|edit <id>] (apelidos: /learning, /memory-graph)	Abre a linha do tempo da jornada de aprendizado, com as skills e memórias aprendidas. Funciona na CLI clássica, como sobreposição na TUI e no aplicativo de desktop (painel Star Map). Não está disponível nas plataformas de mensagens. Veja Jornada de aprendizado.

Configuração

Comando	Descrição
/config	Mostra a configuração atual
/model [nome-do-modelo]	Mostra ou troca o modelo atual. Aceita: /model claude-sonnet-4, /model provider:model (trocar de provedor), /model custom:model (endpoint personalizado), /model custom:name:model (provedor personalizado nomeado), /model custom (detectar automaticamente pelo endpoint) e apelidos definidos por você (/model fav, /model grok — veja Apelidos de modelo personalizados). Flags: --global grava a mudança no config.yaml; --session força só a sessão; --once vale só para o próximo turno; --refresh busca de novo a lista de modelos do provedor; --provider <nome> troca o backend (só na sessão, a menos que use --global). Um /model <nome> simples vale só para a sessão, a menos que model.persist_switch_by_default: true esteja definido. Seletor interativo: rodar /model sem argumentos abre o seletor de provedor→modelo; na lista de modelos você pode digitar para filtrar de forma difusa (por exemplo, digite grok para restringir aos modelos que casam), Backspace para encurtar o filtro, Esc para limpar (ou fechar o seletor). A seleção sempre resolve para um modelo concreto — o filtro só restringe a lista, nunca adivinha. Nota: o /model só consegue alternar entre provedores já configurados. Para acrescentar um provedor novo, saia da sessão e rode hermes model no seu terminal. Nota de custo: trocar de modelo no meio da conversa zera o cache de prompt — a chave de cache inclui o modelo, então o seu próximo turno relê a conversa inteira pelo preço cheio de entrada, em vez da tarifa em cache com cerca de 75% de desconto. É esperado e inevitável, mas vale saber em sessões longas.
/codex-runtime [auto|codex_app_server|on|off]	Liga ou desliga o runtime opcional do app-server do Codex para modelos OpenAI/Codex. O auto (padrão) usa as chat completions padrão do Hermes; o codex_app_server entrega os turnos a um subprocesso codex app-server, com shell nativo, apply_patch, autenticação por assinatura do ChatGPT e plugins do Codex migrados. Vale a partir da próxima sessão.
/personality	Define uma personalidade predefinida. O /personality none (ou default / neutral) remove a camada e volta ao comportamento base.
/verbose	Alterna a exibição do progresso de ferramentas: off → new → all → verbose. Pode ser habilitado para mensagens por configuração.
/focus [on|off|status]	Liga e desliga a visão de foco — um modo apenas de exibição, com saída reduzida, que mostra só o seu prompt e a resposta final. Compõe com o /verbose: ligar a visão de foco trava o progresso de ferramentas em off e lembra o seu modo anterior, e o /focus off restaura. Cada turno termina com uma linha discreta de recuperação (⋯ 7 tool lines hidden · /focus off to show) e um selo persistente ◉ focus fica na barra de status, para você sempre saber que está na visão reduzida. Nada é enviado de forma diferente ao modelo — o detalhe é escondido, nunca descartado.
/fast [normal|fast|status]	Liga e desliga o modo rápido — OpenAI Priority Processing / Anthropic Fast Mode. Opções: normal, fast, status.
/reasoning [nível|show|hide|full|clamp] [--global]	Gerencia o esforço de raciocínio e a exibição dele. Os níveis incluem none / minimal / low / medium / high / xhigh / max / ultra. O show / hide (ou on / off) liga e desliga a exibição do raciocínio; full e clamp ajustam como o raciocínio é mostrado. O --global grava o esforço na configuração.
/skin	Mostra ou troca o skin/tema de exibição
/export [perfil] [-o saida.tar.gz]	Só na CLI. Empacota um perfil num .tar.gz compartilhável — skills, memória, persona, crons, plugins, configurações e (a partir do desktop) temas e layout. As credenciais (auth.json, .env) são removidas. Por padrão, usa o perfil ativo e <nome>.tar.gz no diretório atual. É o mesmo arquivo do hermes profile export; para um compartilhamento versionado e atualizável, use uma distribuição de perfil.
/import <arquivo.tar.gz> [--name <nome>]	Só na CLI. Instala um arquivo de perfil como um perfil novo, inferindo o nome pelo arquivo, a menos que --name seja informado. Recusa sobrescrever um perfil existente e não pode importar como default. Cria um wrapper de shell quando o nome está livre. Veja Exportar e importar um arquivo de perfil.
/statusbar (apelido: /sb)	Liga e desliga a barra de status de contexto/modelo
/battery [on|off|status]	Liga e desliga uma leitura de bateria com código de cores como primeiro elemento da barra de status (desligada por padrão; não faz nada sem bateria).
/voice [on|off|tts|status]	Liga e desliga o modo de voz da CLI e a reprodução falada. A gravação usa a voice.record_key (padrão: Ctrl+B).
/yolo	Liga e desliga o modo YOLO — pula todos os pedidos de aprovação de comandos perigosos.
/approvals [manual|smart|off]	Mostra ou define o modo persistente de aprovação de comandos perigosos.
/footer [on|off|status]	Liga e desliga o rodapé de metadados de execução do gateway nas respostas finais (mostra modelo, % de contexto e o diretório de trabalho).
/busy [queue|steer|interrupt|status]	Só na CLI: controla o que apertar Enter faz enquanto o Hermes está trabalhando — colocar a mensagem nova na fila, ajustar o rumo no meio do turno ou interromper na hora.
/indicator [kaomoji|emoji|unicode|ascii]	Só na CLI: escolhe o estilo do indicador de ocupado da TUI.
/timestamps [on|off|status]	Só na CLI: liga e desliga os horários [HH:MM] nas mensagens e no /history.
/wake [on|off|status]	Só na CLI: liga e desliga o ouvinte da palavra de ativação "Hey Hermes".

Ferramentas e skills

Comando	Descrição
/tools [list|disable|enable] [nome...]	Gerencia ferramentas: lista as ferramentas disponíveis, ou desabilita/habilita ferramentas específicas para a sessão atual. Desabilitar uma ferramenta tira ela do conjunto do agente e dispara uma reinicialização de sessão.
/toolsets	Lista os conjuntos de ferramentas disponíveis
/browser [connect|disconnect|status]	Gerencia uma conexão CDP local com um navegador da família Chromium. O connect liga as ferramentas de navegador a uma instância do Chrome, Brave, Chromium ou Edge em execução (padrão: http://127.0.0.1:9222). O disconnect desconecta. O status mostra a conexão atual. Abre automaticamente um navegador compatível da família Chromium se nenhum depurador for detectado.
/skills	Busca, instala, inspeciona ou gerencia skills de registros online. É também a superfície de revisão do filtro de aprovação de escrita de skills: /skills pending, /skills diff <id>, /skills approve <id>, /skills reject <id>, /skills approval on|off. Veja Controlar as escritas de skills.
/memory [pending|approve|reject|approval]	Revisa as escritas de memória pendentes represadas pelo filtro de aprovação de escrita (memory.write_approval) e liga ou desliga o filtro. Veja Controlar as escritas de memória.
/bundles	Lista os pacotes de skills configurados — apelidos de barra /<nome> que carregam várias skills de uma vez. Configure em bundles: no ~/.hermes/config.yaml. Veja Pacotes de skills.
/learn <do que aprender>	Destila uma skill reutilizável a partir de qualquer coisa que você descreva — um diretório, uma URL, o fluxo que você acabou de percorrer com o agente ou anotações coladas. É aberto: o agente reúne as fontes com as próprias ferramentas e escreve um SKILL.md seguindo os padrões da casa. Funciona na CLI, no gateway de mensagens, na TUI e na página de Skills do painel.
/init [notas]	Gera ou atualiza as instruções de projeto do AGENTS.md a partir de uma varredura do repositório (porte do /init do Codex). O agente inspeciona manifestos, layout e configurações de toolchain com as ferramentas de leitura, e então escreve um AGENTS.md conciso — ou, se já existe um, atualiza por mesclagem, preservando o seu conteúdo. Notas opcionais direcionam a ênfase. Funciona na CLI, no gateway de mensagens e na TUI.
/cron	Gerencia tarefas agendadas (listar, adicionar/criar, editar, pausar, retomar, rodar, remover)
/suggestions [accept|dismiss N|catalog|clear] (apelido: /suggest)	Revisa automações sugeridas. Use /suggestions para listar as sugestões pendentes, /suggestions accept <id> para criar a automação proposta, /suggestions dismiss <id> para recusar uma, /suggestions catalog para acrescentar automações iniciais curadas e /suggestions clear para limpar os registros de sugestão já resolvidos. As tarefas aceitas preservam a superfície atual como origem de entrega.
/blueprint [nome] [slot=valor ...] (apelido: /bp)	Monta uma automação a partir de um modelo. O /blueprint puro lista o catálogo; o /blueprint <nome> inicia um fluxo guiado de preenchimento de campos no próximo turno do agente; o /blueprint <nome> slot=valor ... cria a tarefa direto.
/curator	Manutenção de skills em segundo plano — status, run, pin, archive. Veja Curador.
/kanban <ação>	Toca o quadro de colaboração multiperfil e multiprojeto sem sair do chat. Toda a superfície do hermes kanban está disponível: /kanban list, /kanban show t_abc, /kanban create "título" --assignee X, /kanban comment t_abc "texto", /kanban unblock t_abc, /kanban dispatch, etc. Inclui suporte a vários quadros: /kanban boards list, /kanban boards create <slug>, /kanban boards switch <slug>, /kanban --board <slug> <ação>. Veja Comando de barra /kanban.
/reload-mcp (apelido: /reload_mcp)	Recarrega os servidores MCP a partir do config.yaml
/reload-skills (apelido: /reload_skills)	Varre de novo o ~/.hermes/skills/ em busca de skills recém-instaladas ou removidas
/reload	Recarrega as variáveis do .env na sessão em execução (pega chaves de API novas sem reiniciar)
/plugins	Lista os plugins instalados e o status deles
/pet [list|<slug>]	Alterna ou adota um mascote do petdex. O /pet alterna o painel, o /pet list mostra os pets instalados e o /pet <slug> adota um específico.
/hatch <descrição> (apelido: /generate-pet)	Gera um pet do petdex totalmente novo a partir de uma descrição em texto, usando o backend de imagem configurado (OpenRouter / Nous Portal). Veja Pets.

Informação

Comando	Descrição
/help	Mostra os comandos disponíveis, agrupados por categoria. Os comandos centrais aparecem por padrão, com os comandos de skill encolhidos numa contagem de uma linha; o /help skills lista todos os comandos de skill, e o /help <texto> filtra comandos (e skills correspondentes) por trecho.
/palette	Abre a paleta difusa de comandos (também em Ctrl+P) — digite para filtrar todos os comandos + skills, ↑/↓ para mover, Enter para inserir o comando escolhido no compositor (nunca roda sozinho), Esc para cancelar. A correspondência é ordenada primeiro pelo nome do comando, então uma consulta curta continua precisa.
/version	Mostra a versão, o build e a informação de ambiente do Hermes Agent.
/whoami	Mostra seu nível de acesso a comandos de barra (administrador / usuário).
/usage	Mostra o uso de tokens, o detalhamento de custo, a duração da sessão e — quando o provedor ativo disponibiliza — uma seção de Limites da conta, com cota / créditos / uso do plano restantes, puxados ao vivo da API do provedor.
/topup	Mostra seu saldo Nous e gerencia a cobrança no portal (substitui os antigos comandos /credits e /billing).
/subscription (apelido: /upgrade)	Só na CLI. Vê seu plano Nous e permite mudar ele no navegador.
/insights	Mostra insights e análises de uso (últimos 30 dias)
/update	Atualiza o Hermes Agent para a versão mais recente.
/platforms (apelido: /gateway)	Mostra o status das plataformas de gateway/mensagens (visão de resumo, só na CLI).
/paste	Anexa uma imagem da área de transferência
/copy [número]	Copia a última resposta do assistente para a área de transferência (ou a N-ésima de trás para frente, com um número). Só na CLI.
/image <caminho>	Anexa um arquivo de imagem local para o seu próximo prompt.
/debug	Envia um relatório de depuração (informação de sistema + logs) e devolve links compartilháveis. Também disponível nas mensagens.
/update	Atualiza o Hermes Agent para a versão mais recente.
/profile	Mostra o nome do perfil ativo e o diretório base dele

Sair

Comando	Descrição
/quit	Sai da CLI (também: /exit).

Comandos de barra dinâmicos da CLI

Comando	Descrição
/<nome-da-skill>	Carrega qualquer skill instalada como um comando sob demanda. Exemplo: /gif-search, /github-pr-workflow, /excalidraw.
/skills ...	Busca, navega, inspeciona, instala, audita, publica e configura skills de registros e do catálogo oficial de skills opcionais.

Comandos rápidos

Comandos rápidos definidos por você mapeiam um comando de barra curto para um comando de shell ou para outro comando de barra. Configure eles em ~/.hermes/config.yaml:

quick_commands:
  status:
    type: exec
    command: systemctl status hermes-agent
  deploy:
    type: exec
    command: scripts/deploy.sh
  inbox:
    type: alias
    target: /gmail unread

Depois digite /status, /deploy ou /inbox na CLI ou numa plataforma de mensagens. Os comandos rápidos são resolvidos na hora do despacho e podem não aparecer em toda tabela embutida de autocompletar/ajuda.

Atalhos de prompt que são só texto não são aceitos como comandos rápidos. Coloque prompts reutilizáveis mais longos numa skill, ou use type: alias para apontar para um comando de barra existente.

Apelidos de modelo personalizados

Defina seus próprios nomes curtos para os modelos que você usa bastante e alcance eles com /model <apelido> na CLI ou em qualquer plataforma de mensagens. Os apelidos funcionam igual nas duas, tanto em trocas só de sessão (o padrão) quanto com --global.

Dois formatos de configuração são aceitos:

Forma completa — fixa um modelo exato, um provedor e, se quiser, uma URL base. Coloque isto no ~/.hermes/config.yaml:

model_aliases:
  fav:
    model: claude-sonnet-4.6
    provider: anthropic
  grok:
    model: grok-4
    provider: x-ai
  ollama-qwen:
    model: qwen3-coder:30b
    provider: custom
    base_url: http://localhost:11434/v1

Forma curta — provider/model numa string só. Dá para definir pelo shell, sem editar YAML:

hermes config set model.aliases.fav anthropic/claude-opus-4.6
hermes config set model.aliases.grok x-ai/grok-4

Depois, no chat:

/model fav            # só na sessão
/model grok --global  # também grava a mudança de modelo atual no config.yaml

Os apelidos do usuário têm precedência sobre os nomes curtos embutidos, então chamar um apelido de sonnet, kimi, opus etc. vai encobrir o embutido. Os nomes de apelido não diferenciam maiúsculas de minúsculas.

Resolução de apelidos

Os comandos aceitam correspondência por prefixo: digitar /h resolve para /help, /mod resolve para /model. Quando um prefixo é ambíguo (casa com vários comandos), vence a primeira correspondência na ordem do registro. Nomes completos de comando e apelidos registrados sempre têm prioridade sobre as correspondências por prefixo.

Comandos de barra de mensagens

Comandos em thread do Slack (prefixo !): O próprio Slack bloqueia comandos de barra nativos dentro de threads de mensagem ("/queue is not supported in threads. Sorry!") e nunca entrega eles ao Hermes. Dentro de uma thread do Slack, use o prefixo ! — !stop, !new, !status — e o gateway despacha exatamente como na forma com barra. @Hermes !stop e @Hermes /stop também funcionam em threads. Só o primeiro token é comparado com a lista de comandos conhecidos, então mensagens como !nice work passam intactas para o agente. Veja Usar comandos dentro de threads para detalhes.

O gateway de mensagens aceita os seguintes comandos embutidos dentro de conversas no Telegram, Discord, Slack, WhatsApp, Signal, e-mail, Home Assistant e Teams:

Comando	Descrição
/start	Comando de protocolo da plataforma. Muitas plataformas de conversa (Telegram, Discord, …) mandam /start automaticamente na primeira vez que um usuário abre uma conversa com o bot. O Hermes reconhece o ping em silêncio — sem resposta do agente, sem queimar sessão — para que os apertos de mão de primeiro contato não gastem um turno. Você também pode mandar explicitamente para confirmar que o gateway está alcançável.
/new [nome] (apelido: /reset)	Começa uma sessão nova (ID de sessão e histórico zerados). O [nome] opcional define o título inicial da sessão. Acrescente now, --yes ou -y para pular a janela de confirmação — por exemplo, /reset now, /new --yes meu-experimento.
/status	Mostra informação da sessão, seguida de um bloco local de Resumo da sessão (contagens recentes de turnos, ferramentas mais usadas, arquivos tocados, prompt e resposta mais recentes).
/stop	Mata todos os processos em segundo plano em execução e interrompe o agente que está rodando.
/model [provider:model]	Mostra ou troca o modelo. Aceita trocas de provedor (/model zai:glm-5), endpoints personalizados (/model custom:model), provedores personalizados nomeados (/model custom:local:qwen), detecção automática (/model custom) e apelidos definidos por você (/model fav, /model grok — veja Apelidos de modelo personalizados). Use --global para gravar a mudança no config.yaml. Nota: o /model só consegue alternar entre provedores já configurados. Para acrescentar um provedor novo ou configurar chaves de API, use hermes model no seu terminal (fora da sessão de chat). Nota de custo: trocar de modelo no meio da sessão zera o cache de prompt (a chave de cache inclui o modelo), então a próxima mensagem relê a conversa inteira pelo preço cheio de entrada.
/codex-runtime [auto|codex_app_server|on|off]	Liga ou desliga o runtime opcional do app-server do Codex. Grava em model.openai_runtime no config.yaml e descarta o agente em cache, para a próxima mensagem pegar o runtime novo. Vale a partir da próxima sessão.
/personality [nome]	Define uma camada de personalidade para a sessão. O /personality none (ou default / neutral) remove ela.
/fast [normal|fast|status]	Liga e desliga o modo rápido — OpenAI Priority Processing / Anthropic Fast Mode.
/retry	Tenta a última mensagem de novo.
/undo	Remove a última troca.
/sethome (apelido: /set-home)	Marca a conversa atual como o canal principal da plataforma para as entregas.
/compress [here [N] | focus tópico]	Compacta manualmente o contexto da conversa. O /compress here [N] mantém as N trocas mais recentes (padrão 2) na íntegra e resume o resto. Um tópico de foco restringe o que um resumo completo preserva.
/topic [off|help|session-id]	Só em DM do Telegram. Gerencia o modo de tópicos com várias sessões, controlado pelo usuário. O /topic habilita ou mostra o status; o /topic off desabilita e limpa os vínculos; o /topic help mostra o uso; o /topic <session-id> dentro de um tópico restaura uma sessão anterior. Veja Modo de DM com várias sessões.
/title [nome]	Define ou mostra o título da sessão.
/resume [nome]	Retoma uma sessão nomeada anteriormente.
/sessions [all] [search <consulta>]	Lista as sessões anteriores desta conversa. O /sessions search <consulta> filtra por correspondência de título/id (as mais ativas recentemente primeiro); o /sessions all lista entre origens (só administrador).
/usage	Mostra o uso de tokens, o detalhamento estimado de custo (entrada/saída), o estado da janela de contexto, a duração da sessão e — quando o provedor ativo disponibiliza — uma seção de Limites da conta, com cota / créditos restantes puxados ao vivo da API do provedor.
/topup	Mostra seu saldo Nous e gerencia a cobrança no portal.
/whoami	Mostra seu nível de acesso a comandos de barra (administrador / usuário).
/insights [dias]	Mostra análises de uso.
/reasoning [nível|show|hide|full|clamp] [--global]	Muda o esforço de raciocínio (níveis até max / ultra) ou liga e desliga a exibição do raciocínio (full / clamp incluídos). O --global grava na configuração.
/voice [on|off|tts|join|channel|leave|status]	Controla as respostas faladas no chat. O join/channel/leave gerencia o modo de canal de voz do Discord.
/rollback [número]	Lista ou restaura checkpoints do sistema de arquivos.
/diff [staged|all|session] [--stat]	Mostra as mudanças do git no diretório de trabalho (em bloco de código e truncadas para os limites de mensagem da plataforma). O session mostra o diff acumulado de tudo que o Hermes mudou; o --stat mostra só o resumo.
/background <prompt>	Roda um prompt numa sessão separada em segundo plano. Os resultados são entregues de volta na mesma conversa quando a tarefa termina. Veja Sessões em segundo plano nas mensagens.
/queue <prompt> (apelido: /q)	Coloca um prompt na fila para o próximo turno sem interromper o atual.
/steer <prompt>	Injeta uma mensagem depois da próxima chamada de ferramenta sem interromper — o modelo pega ela na iteração seguinte, e não como um turno novo.
/goal <texto>	Define uma meta permanente na direção da qual o Hermes trabalha ao longo dos turnos — a nossa versão do laço Ralph. Um modelo juiz confere depois de cada turno; se não estiver pronta, o Hermes continua sozinho até ficar, até você pausar/limpar, ou até estourar o orçamento de turnos (padrão 20). Subcomandos: /goal status, /goal pause, /goal resume, /goal clear. É seguro rodar com o agente ativo para status/pause/clear; definir uma meta nova exige um /stop antes. Veja Metas persistentes.
/subgoal <texto>	Acrescenta critérios ao /goal ativo no meio do laço (/subgoal, /subgoal remove <N>, /subgoal clear).
/heartbeat every <intervalo> <prompt> (apelido: /hb)	Define um prompt recorrente que volta a entrar nesta sessão quando ela está ociosa. Subcomandos: status, pause, resume, clear. No Slack, use /hermes heartbeat ….
/refine [foco]	Roda agora a revisão de automelhoria de memória/skills, opcionalmente com instruções de foco. No Slack, use /hermes refine ….
/review [instruções]	Cria um subagente revisor independente para o trabalho que acabou de ser discutido (PR, código, documentação); a revisão dele volta a entrar nesta conversa quando termina. No Slack, use /hermes review ….
/moa <prompt>	Roda um prompt pelo preset padrão de Mistura de Agentes e depois restaura o modelo da sessão.
/branch [nome] (apelido: /fork)	Ramifica a sessão atual (para explorar um caminho diferente).
/agents (apelido: /tasks)	Mostra os agentes ativos e as tarefas em execução.
/sessions	Navega e retoma sessões anteriores.
/context [all] (apelido: /ctx)	Medidor de uso da janela de contexto e detalhamento por categoria (em forma de texto amigável para mensagens). O /context all acrescenta o detalhe de custo por skill / por conjunto de ferramentas.
/egress [status]	Mostra o status do proxy de saída do Docker.
/init [notas]	Gera ou atualiza o AGENTS.md a partir de uma varredura do repositório.
/learn <do que aprender>	Destila uma skill reutilizável a partir de qualquer coisa que você descreva.
/bundles	Lista os pacotes de skills configurados (apelidos /<nome> que carregam várias skills).
/reload-skills (apelido: /reload_skills)	Varre de novo o ~/.hermes/skills/ em busca de skills recém-instaladas ou removidas.
/footer [on|off|status]	Liga e desliga o rodapé de metadados de execução nas respostas finais (mostra modelo, % de contexto e o diretório de trabalho).
/curator [status|run|pin|archive]	Controles de manutenção de skills em segundo plano.
/suggestions [accept|dismiss N|catalog|clear]	Revisa automações sugeridas direto no chat. O /suggestions lista as sugestões pendentes, o catalog acrescenta automações iniciais curadas e o clear limpa os registros de sugestão resolvidos. As sugestões aceitas mantêm esta conversa/thread como origem de entrega da tarefa.
/blueprint [nome] [slot=valor ...]	Navega pelos modelos de cron, começa uma conversa guiada de preenchimento de campos ou cria uma tarefa de modelo direto. As tarefas criadas direto entregam de volta na conversa/thread atual.
/memory [pending|approve|reject|approval]	Revisa as escritas de memória pendentes represadas pelo filtro de aprovação de escrita (memory.write_approval) — aprove ou rejeite direto no chat — e liga ou desliga o filtro com /memory approval on|off. Veja Controlar as escritas de memória.
/skills [pending|approve|reject|diff|approval]	Revisa as escritas de skill pendentes represadas pelo filtro de aprovação de escrita (skills.write_approval). Mostra um resumo de uma linha por escrita represada; o /skills diff <id> é truncado para o chat — leia o diff completo na CLI ou em ~/.hermes/pending/skills/<id>.json. Só aparece quando o filtro está ligado (ou quando restam escritas represadas); busca e instalação continuam só na CLI.
/kanban <ação>	Toca o quadro de colaboração multiperfil e multiprojeto pelo chat — superfície de argumentos idêntica à da CLI. Passa por cima da proteção de agente ocupado, então /kanban unblock t_abc, /kanban comment t_abc "…", /kanban list --mine, /kanban boards switch <slug> etc. funcionam no meio do turno. O /kanban create … inscreve automaticamente a conversa de origem nos eventos de terminal da nova tarefa. Veja Comando de barra /kanban.
/platform <list|pause|resume> [nome]	Opera uma plataforma de gateway em execução direto do chat. O /platform list mostra todo adaptador e o estado dele (rodando, pausado pelo disjuntor, pausado manualmente); o /platform pause <nome> para de despachar mensagens novas para aquele adaptador sem descarregar ele; o /platform resume <nome> reabilita e limpa um disjuntor acionado, assim que o serviço de origem estiver saudável.
/reload-mcp (apelido: /reload_mcp)	Recarrega os servidores MCP a partir da configuração.
/verbose	Alterna a exibição do progresso de ferramentas. Desligado por padrão nas mensagens — habilite com display.tool_progress_command: true no config.yaml.
/yolo	Liga e desliga o modo YOLO — pula todos os pedidos de aprovação de comandos perigosos.
/commands [página]	Navega por todos os comandos e skills (paginado).
/approve [session|always]	Aprova e executa um comando perigoso pendente. O session aprova só para esta sessão; o always acrescenta à lista permanente de permitidos.
/deny	Rejeita um comando perigoso pendente.
/update	Atualiza o Hermes Agent para a versão mais recente.
/restart	Reinicia o gateway com elegância, depois de drenar as execuções ativas. Quando o gateway volta, ele manda uma confirmação para a conversa/thread de quem pediu.
/debug	Envia um relatório de depuração (informação de sistema + logs) e devolve links compartilháveis.
/help	Mostra a ajuda de mensagens.
/<nome-da-skill>	Invoca qualquer skill instalada pelo nome.

Notas

• /skin, /snapshot, /export, /import, /reload, /tools, /toolsets, /browser, /config, /cron, /platforms, /paste, /image, /statusbar, /battery, /focus, /plugins, /busy, /indicator, /wake, /journey, /redraw, /clear, /history, /save, /copy, /handoff, /prompt, /pet, /hatch, /timestamps, /subscription e /quit são comandos só da CLI.
• O /skills é só da CLI para buscar/navegar/instalar; os subcomandos de revisão da aprovação de escrita (pending, approve, reject, diff, approval) também funcionam nas plataformas de mensagens quando o skills.write_approval está ligado. O /memory funciona nas duas superfícies.
• O /verbose é só da CLI por padrão, mas pode ser habilitado para as plataformas de mensagens definindo display.tool_progress_command: true no config.yaml. Quando habilitado, ele alterna o modo display.tool_progress e salva na configuração.
• O /focus e o /verbose compartilham um único caminho de supressão (display.tool_progress), então eles nunca podem se contradizer: o /focus on trava o progresso de ferramentas em off e guarda o seu modo em display.focus_saved_tool_progress; o /focus off restaura; alternar o /verbose com o foco ligado retoma o controle do modo e apaga o selo de foco. A visão de foco é só de exibição — ela nunca muda o histórico da conversa, o prompt de sistema, nem nada que é enviado ao modelo, então tem impacto zero no cache de prompt.
• /sethome, /restart, /approve, /deny, /topic, /platform e /commands são comandos só de mensagens.
• /status, /egress, /version, /whoami, /background, /queue, /steer, /voice, /reload-mcp, /reload-skills, /rollback, /diff, /debug, /fast, /approvals, /footer, /curator, /kanban, /topup, /suggestions, /blueprint, /learn, /init, /sessions e /yolo funcionam tanto na CLI quanto no gateway de mensagens.
• /voice join, /voice channel e /voice leave só fazem sentido no Discord.
• Na TUI, o /sessions mostra as sessões ao vivo do processo de TUI atual. Use /resume [nome] ou hermes --tui --resume <id-ou-título> para transcrições salvas ou fechadas.

Confirmações para comandos destrutivos

A CLI pergunta antes de rodar comandos de barra que jogam fora estado de sessão não salvo. O conjunto destrutivo atual é:

Comando	O que ele destrói
/clear	Limpa a tela e começa uma sessão nova — o ID de sessão atual e o histórico em memória se vão.
/new / /reset	Começa uma sessão nova (ID de sessão novo + histórico vazio).
/undo	Remove a última troca entre usuário e assistente do histórico.
/exit --delete / /quit --delete	Sai e apaga permanentemente o histórico em SQLite e as transcrições em disco da sessão atual.

Para cada um deles a CLI abre uma janela de três escolhas: Aprovar uma vez (seguir desta vez), Aprovar sempre (seguir e gravar approvals.destructive_slash_confirm: false, para que comandos destrutivos futuros rodem sem perguntar) ou Cancelar.

Pular na hora: acrescente now, --yes ou -y para contornar a janela numa única invocação — por exemplo, /reset now, /new --yes minha-sessao, /clear -y, /undo -y. Útil quando a janela não é renderizada direito no seu terminal (veja a issue #30768 para o PowerShell nativo do Windows) ou quando você automatiza a CLI por script.

Defina approvals.destructive_slash_confirm: false no ~/.hermes/config.yaml para desligar as confirmações globalmente; volte para true para reabilitar. Veja Segurança — Confirmação de comandos de barra destrutivos para o contexto.

---