Last updated on

10 Truques Ocultos do Hermes que Até Usuários Veteranos Podem Não Conhecer: Do /goal aos Pets e um Servidor de API


A superfície de recursos do Hermes Agent é absurdamente longa: mais de 60 subcomandos de CLI, mais de 80 slash commands. Muitos usuários veteranos abrem hermes chat todos os dias sem notar a prateleira inteira de subcomandos “bom de ter” bem ao lado — alguns que te salvam de dizer “continue” três vezes, um que transforma o Hermes em um backend de API para qualquer app, e outros que só deixam seu terminal mais divertido.

Cada truque deste artigo foi testado em uma instalação real (ou verificado palavra por palavra na documentação oficial). Nada de ouvir dizer. Se você leu nosso resumo de dicas de produtividade anterior, considere este o “follow-up avançado” — cada item aqui é conteúdo novo.

1. /goal: diga uma vez, deixe trabalhar até concluir

Este é o mais subestimado. O /goal dá ao Hermes um objetivo persistente que sobrevive entre turnos: após cada turno, um modelo juiz leve verifica se o objetivo foi atingido. Se não foi, o Hermes alimenta automaticamente um prompt de continuação de volta na mesma sessão e continua trabalhando — até concluir, você pausar ou limpar, ou o orçamento de turnos acabar.

/goal Fix every failing test in tests/hermes_cli/ and make sure scripts/run_tests.sh passes for that directory

As docs são explícitas de que esta é uma implementação de Ralph loop inspirada no /goal do Codex CLI 0.128.0. Ele brilha em tarefas em que você teria que dizer “continue” três vezes (corrigir todos os erros de lint, portar uma feature e deixar o CI verde, escrever um relatório). Tarefas de um turno não precisam de /goal.

2. hermes import-agent: migre do Claude Code / Codex em um comando

Se você usa Claude Code ou Codex CLI, mudar para o Hermes não é recomeçar do zero — é um comando:

hermes import-agent                    # auto-detect ~/.claude or ~/.codex
hermes import-agent claude-code        # explicit source
hermes import-agent codex --dry-run    # preview only, never touches disk
hermes import-agent claude-code --overwrite --yes

Ele mapeia suas instruções CLAUDE.md / AGENTS.md, allowlists de permissão, MCP servers, skills e memórias existentes para seus equivalentes no Hermes. A decisão de design chave: chaves de API e credenciais nunca são importadas — essas passam pelo hermes setup. E é sempre preview-first: --dry-run não toca no disco.

3. hermes journey: desenhe sua memória e skills como um starmap

O app desktop tem um painel “Star Map / Memory Graph” — muitos não percebem que ele tem um equivalente no terminal:

hermes journey            # timeline bar chart: skills/memories learned over time
hermes journey --play     # playable "constellation scrubber" animation
hermes journey list       # list node IDs (for delete/edit)
hermes journey delete <id>      # delete a learned skill or memory
hermes journey edit <id>        # edit in $EDITOR

Ele mostra, de relance, quando o Hermes aprendeu cada skill e quais memórias se estabeleceram. Há também um overlay /journey correspondente no TUI. Para quem quer “fazer um balanço do crescimento do seu agente”, isso é melhor do que fuçar em ~/.hermes/skills/.

4. hermes insights: seu uso, de relance

hermes insights                  # last 30 days
hermes insights --days 7         # custom window
hermes insights --source cli     # filter by platform

Saída real da minha máquina: sessões, mensagens, chamadas de ferramenta, tokens de entrada/saída/total, tempo ativo, distribuição de modelos (qual modelo queimou quantos tokens), detalhamento por plataforma, padrões de uso de ferramentas, estimativas de custo. Uma janela de 7 dias retornou instantaneamente 30 sessões, 1.342 mensagens, 767 chamadas de ferramenta e 47,5M de tokens no total — se você já se perguntou “o que meu agente está fazendo de fato, e para onde está indo meu dinheiro”, este comando é a resposta.

5. hermes proxy: transforme o Hermes em uma API compatível com OpenAI

Quer que qualquer app que fale o protocolo OpenAI (Open WebUI, LobeChat, ChatBox…) use o conjunto completo de ferramentas do Hermes? O hermes proxy roda um servidor HTTP local:

hermes proxy start       # run the local OpenAI-compatible proxy
hermes proxy status      # check upstream readiness
hermes proxy providers   # list available upstreams

Como funciona: apps externos apontam para o proxy com qualquer bearer token; o proxy troca por suas credenciais OAuth reais (ex.: Nous Portal) ao encaminhar. Assim, os frontends ganham um backend de agente com terminal, arquivos, busca web, memória e skills — não uma API de modelo crua. A documentação oficial descreve o servidor de API da mesma forma: qualquer frontend em formato OpenAI pode se conectar.

6. hermes sync: skills que te acompanham

Cansado de copiar pastas de skills entre máquinas? O hermes sync é a resposta oficial entre dispositivos:

hermes sync status       # what's synced and from where
hermes sync pull         # pull (including org-shared skills)
hermes sync push         # push your opted-in skills
hermes sync now          # reconcile: pull then push
hermes sync enable <skill> / disable <skill>
hermes sync device       # set this device's label
hermes sync propose      # propose a personal skill back to the team

Skills pessoais transitam entre seus dispositivos; se você pertence a uma organização, também recebe as skills compartilhadas dela e pode contribuir com as suas melhores de volta. O status diz exatamente de onde veio cada skill e para onde ela sincroniza.

7. hermes pets: dê um pet ao seu agente

Sem propósito, e genuinamente divertido. O Petdex é uma galeria pública de pets animados em sprite (medi 4.425 pets em um pets list ao vivo). Instale um e o Hermes o exibe reagindo à atividade do agente no CLI, TUI e desktop:

hermes pets list              # browse the gallery
hermes pets install <name>    # install a pet
hermes pets select <name>     # set the active pet
hermes pets show              # animate it in the terminal
hermes pets scale 2           # resize
hermes pets off               # disable

De Homelander a 机甲小白 a um Dalek, tem um para cada gosto. Vê-lo quicando enquanto seu agente trabalha é uma mudança real de clima.

8. hermes skin set: recolorir na hora, sem editar config

O sistema de skins não é só “trocar temas” — você pode ajustar uma cor de um elemento de UI no lugar:

hermes skin list            # list available skins
hermes skin use <name>      # switch skins
hermes skin set ui_tool '#00FFFF'   # recolor a single element

O subcomando set ajusta uma cor da skin ativa (a família ui_*) sem editar YAML ou reiniciar. A forma mais leve de refinar a aparência do seu terminal.

9. hermes memory: conecte um cérebro de memória externo

Além do MEMORY.md/USER.md embutido, o Hermes suporta provedores de memória externa plugáveis:

hermes memory setup      # interactive provider selection + config
hermes memory status     # show current provider
hermes memory off        # disable external memory (built-in only)
hermes memory reset      # wipe built-in memory

Provedores disponíveis: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover — apenas um ativo por vez. Se você quer uma camada de memória de longo prazo séria (memória estilo recuperação semântica), esta é a porta de entrada oficial.

10. hermes egress: firewall de egress em sandbox (easter egg de segurança)

O mais “hardcore”: o iron-proxy é um firewall de egress com interceptação TLS opcional que troca tokens de proxy por credenciais de API reais antes de as requisições saírem de uma sandbox. Desabilitado por padrão:

hermes egress install     # download the iron-proxy binary
hermes egress setup       # interactive wizard (install + CA + mint tokens + config)
hermes egress start / stop / restart / status
hermes egress disable

Para workloads rodando em ambientes com sandbox/isolados que ainda precisam alcançar APIs reais, ele resolve o clássico problema “não posso colocar credenciais reais na sandbox”. Usuários avançados, anotem.

Bônus: one-liners que valem guardar

  • hermes monitoring status: métricas de saúde do gateway + estado de exportação OTLP de diagnósticos redigidos (desligado por padrão; puramente operacional)
  • /wake on: um comando para habilitar o “Hey Hermes” mãos-livres (a detecção é inteiramente no dispositivo; o áudio nunca sai da sua máquina). Veja os docs do wake word
  • hermes security: auditoria de supply-chain OSV.dev de venvs, plugins e MCP servers — para os obcecados por segurança
  • hermes dump: um comando exporta um resumo completo da configuração para suporte/debug

Como encontrar mais

O hermes --help lista todos os 60+ subcomandos, e cada um tem uma descrição detalhada via hermes <cmd> --help. Os docs de features oficiais também são uma mina de ouro — páginas como pets.md, skins.md, goals.md e wake-word.md contam sua própria história.

Quer o quadro completo? Comece com nosso resumo de dicas de produtividade (nomes de sessão, compressão, checkpoints — os fundamentos) e depois combine com este lote avançado. Se você chegou depois da v0.20, leia primeiro o mergulho profundo no release Herald para ver o release inteiro.