Hermes Agent Cheatsheet

01

Instalação

Iniciante No meu fluxo

Requisitos: Linux, macOS, WSL2 ou Windows nativo. O instalador automático baixa uv, Python 3.11, clona o repo e configura tudo — sem sudo. No meu fluxo, instalo em máquinas novas em <2min e o agente já lembra meu padrão de commits em PT-BR e auditorias SEO do dia 1.

Linux / macOS / WSL2 / Termux

Instalação automática via curl — método recomendado

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (PowerShell nativo)

Windows nativo ou WSL2. O instalador configura MinGit (~45MB) sem admin.

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Após instalar

source ~/.bashrc # ou ~/.zshrc

hermes setup --portal

hermes

hermes setup --portal faz OAuth único que cobre modelo + Tool Gateway (web search, image gen, TTS, browser e terminal cloud opcional). Depois é só digitar hermes e começar. Prefere TUI? Use hermes --tui.

Vindo do OpenClaw? hermes claw migrate importa SOUL.md, memórias, skills e API keys de ~/.openclaw. Use --dry-run para pré-visualizar. (No meu fluxo migrei 3x sem perda de histórico de loops.)

Windows: O instalador nativo salva em %LOCALAPPDATA%\hermes. WSL2/Linux usam ~/.hermes. No Android/Termux, use a extra .[termux] — a extra .[all] tem dependências de voz incompatíveis.

Isso é o primeiro passo da Trilha de Autonomia que ensino no meu método e blog: comece simples, o sistema cresce com o uso repetido do loop.

02

Comandos CLI

Iniciante No meu fluxo

Comandos de terminal executados fora da sessão interativa. Use hermes --help para ver todos. No meu fluxo diário, uso hermes status + /insights para medir o ganho do loop do método antes de qualquer reunião de mentoring.

Comando	O que faz	Exemplo
`hermes`	Inicia sessão interativa (CLI padrão)	`hermes`
`hermes chat`	Chat interativo ou one-shot	`hermes chat -q "hello"`
`hermes setup`	Wizard de configuração interativa	`hermes setup --portal`
`hermes model`	Escolhe provedor e modelo de LLM	`hermes model`
`hermes tools`	Configura ferramentas habilitadas	`hermes tools`
`hermes config`	Mostra/edita configuração	`hermes config set model anthropic/claude-sonnet-4.6`
`hermes update`	Atualiza para a versão mais recente	`hermes update`
`hermes doctor`	Diagnostica problemas de config/dependências	`hermes doctor`
`hermes gateway`	Inicia o gateway de mensagens	`hermes gateway`
`hermes gateway setup`	Wizard de configuração do gateway	`hermes gateway setup`
`hermes gateway install`	Instala gateway como serviço (systemd / launchd)	`hermes gateway install`
`hermes gateway start`	Inicia o serviço do gateway	`hermes gateway start`
`hermes gateway stop`	Para o serviço do gateway	`hermes gateway stop`
`hermes gateway status`	Status do serviço do gateway	`hermes gateway status`
`hermes auth`	Gerencia credenciais OAuth e API keys	`hermes auth add nous`
`hermes pairing`	Aprova/revoga acesso ao bot (DM pairing)	`hermes pairing approve telegram ABC12DEF`
`hermes send`	Envia mensagem one-shot (sem LLM)	`hermes send telegram "Alerta"`
`hermes fallback`	Gerencia provedores de fallback	`hermes fallback`
`hermes logs`	Visualiza logs do agent/gateway	`hermes logs --tail`
`hermes checkpoints`	Inspeciona checkpoints do filesystem	`hermes checkpoints`
`hermes plugins`	Instala/ativa plugins (ex.: Honcho)	`hermes plugins`
`hermes claw`	Migração do OpenClaw	`hermes claw migrate`
`hermes skills`	Gerencia skills (browse, install, publish, audit)	`hermes skills`
`hermes cron`	Inspeciona/executa o scheduler de tarefas	`hermes cron list`
`hermes sessions`	Gerencia sessões (browse, export, prune, rename)	`hermes sessions`
`hermes insights`	Analytics de tokens, custo e atividade	`hermes insights --days 7`
`hermes mcp`	Gerencia servidores MCP	`hermes mcp`
`hermes portal`	Status do Nous Portal, subscription, Tool Gateway	`hermes portal info`
`hermes profile`	Gerencia perfis isolados do Hermes	`hermes profile`
`hermes backup`	Backup do diretório ~/.hermes para zip	`hermes backup`
`hermes import`	Restaura de backup zip	`hermes import backup.zip`
`hermes status`	Status do agent, auth e plataformas	`hermes status`
`hermes dump`	Resumo copiável para suporte	`hermes dump`
`hermes debug`	Coleta logs e envia para suporte da Nous Research	`hermes debug`
`hermes desktop`	Inicia o app Desktop (Electron, macOS/Linux/Windows)	`hermes desktop`
`hermes dashboard`	Abre o Admin Panel web no browser	`hermes dashboard`
`hermes dashboard register`	Registra usuário no Admin Panel (OIDC/local auth)	`hermes dashboard register`
`hermes uninstall`	Remove Hermes do sistema	`hermes uninstall`

Flags globais úteis: --profile <nome>, --resume <session>, --continue, --worktree, --yolo (pula aprovações — use com cautela), --tui (TUI com overlays e mouse), --cli (força REPL clássico), --ignore-rules (ignora AGENTS.md/SOUL.md). Interface padrão: display.interface: cli|tui em config.yaml.

03

Slash Commands

Iniciante

Digite / no chat para abrir o autocomplete. Funciona em CLI e em todas as plataformas de mensagem (Telegram, Discord, Slack, etc.).

Comando	O que faz	Exemplo
`/new [name]`	Nova sessão (fresh ID + histórico). Opcional: nome	`/new my-experiment`
`/reset`	Alias de `/new`	`/reset now` (skip confirmação)
`/clear`	Limpa tela e inicia nova sessão	`/clear`
`/history`	Mostra histórico da conversa	`/history`
`/save`	Salva conversa atual	`/save`
`/retry`	Reenvia última mensagem ao agente	`/retry`
`/undo [N]`	Desfaz os últimos N turnos; pré-preenche última msg para editar	`/undo 2`
`/title <name>`	Define título da sessão	`/title Auth Refactor`
`/compress [focus]`	Comprime contexto manualmente. Foco opcional	`/compress mantenha arquitetura`
`/rollback [number]`	Lista/restaura checkpoints do filesystem	`/rollback`
`/snapshot`	Cria/restaura snapshots de estado	`/snapshot create pre-mudanca`
`/stop`	Mata todos os processos em background	`/stop`
`/queue <prompt>`	Enfileira prompt para próximo turno	`/queue "verifique testes"`
`/steer <prompt>`	Injeta nota mid-run após próxima tool call	`/steer "foco no auth module"`
`/busy [mode]`	Define comportamento com agente ocupado: interrupt, queue ou steer	`/busy steer`
`/goal <text>`	Objetivo persistente multi-turn (Ralph loop). Subcmds: status, pause, resume, clear	`/goal refatorar auth`
`/subgoal <text>`	Adiciona critério ao goal ativo	`/subgoal "usar JWT"`
`/resume [name]`	Retoma sessão por nome	`/resume auth-refactor`
`/sessions`	Navegador de sessões (browse/resume)	`/sessions`
`/background <prompt>`	Executa em sessão background separada	`/bg "pesquise sobre X"`
`/branch [name]`	Ramifica conversa atual	`/branch alternativa`
`/handoff <platform>`	Transfere sessão para plataforma (CLI only)	`/handoff telegram`
`/model [model]`	Muda modelo. `--global` persiste	`/model claude-sonnet-4`
`/tools`	Lista/toggle ferramentas da sessão	`/tools`
`/skills`	Busca, instala e gerencia skills	`/skills`
`/cron`	UI de tarefas agendadas	`/cron`
`/reload`	Recarrega .env sem reiniciar	`/reload`
`/reload-mcp`	Recarrega servidores MCP	`/reload-mcp`
`/usage`	Tokens e custo da sessão	`/usage`
`/insights`	Analytics snapshot	`/insights --days 7`
`/config`	Mostra configuração atual	`/config`
`/personality`	Define personalidade predefinida	`/personality`
`/verbose`	Cicla display de progresso: off → new → all → verbose	`/verbose`
`/fast`	Toggle fast mode (OpenAI Priority / Anthropic Fast)	`/fast`
`/reasoning`	Gerencia reasoning effort e display	`/reasoning`
`/voice`	Toggle voice mode. Gravação: Ctrl+B	`/voice on`
`/yolo`	Toggle YOLO — pula todas as aprovações	`/yolo`
`/status`	Info da sessão + recap local	`/status`
`/agents`	Agentes e tarefas ativas (alias: `/tasks`)	`/agents`
`/whoami`	Mostra seu nível de acesso no gateway (admin/user)	`/whoami`
`/sethome`	Define este chat como canal home (necessário para `/handoff`)	`/sethome`
`/approve` / `/deny`	Aprova ou rejeita comando perigoso pendente (gateway)	`/approve`
`/update`	Atualiza o Hermes para a versão mais recente	`/update`
`/help`	Lista todos os comandos	`/help`
`/quit`	Sai do CLI	`/quit`

/steer e /busy: Use /steer para nudar o agente mid-task sem interromper — o texto chega após a próxima tool call. Configure o padrão com /busy steer, /busy queue ou /busy interrupt (ou display.busy_input_mode no config.yaml).

04

Configuração

Intermediário

Toda configuração vive em ~/.hermes/. Segredos vão para .env, o resto para config.yaml.

1

CLI flags Maior prioridade — sobrescreve tudo

2

~/.hermes/config.yaml Configurações principais (não-segredos)

3

~/.hermes/.env Segredos: API keys, tokens, passwords

4

Built-in defaults Valores padrão hardcoded

Estrutura do ~/.hermes/

~/.hermes/
├── config.yaml          # Configurações (modelo, terminal, TTS, compressão)
├── gateway-config.yaml  # Config do gateway (plataformas, allowlists)
├── gateway.json         # Políticas de reset de sessão por plataforma
├── .env                 # API keys e segredos
├── auth.json            # OAuth credentials (Nous Portal, etc.)
├── SOUL.md              # Identidade principal do agente
├── memories/            # Memórias persistentes (MEMORY.md, USER.md)
├── skills/              # Skills criadas/instaladas
├── pairing/             # Usuários aprovados via DM pairing
├── checkpoints/         # Shadow store do /rollback
├── cron/                # Tarefas agendadas
├── sessions/            # Sessões do gateway
└── logs/                # Logs (erros e gateway, segredos redacted)

Ver configuração

hermes config

Editar configuração

hermes config edit

Set valor específico

hermes config set KEY VAL

API keys vão automaticamente para .env; o resto para config.yaml

Verificar config

hermes config check

Detecta opções faltantes após updates

Exemplo de config.yaml

model: anthropic/claude-sonnet-4.6
display:
  interface: tui          # ou cli
  busy_input_mode: steer  # interrupt | queue | steer
terminal:
  backend: docker
  timeout: 180
compression:
  enabled: true
  threshold: 0.50
  target_ratio: 0.20
  protect_last_n: 20
approvals:
  mode: manual            # manual | smart | off
worktree: true
quick_commands:
  status:
    type: exec
    command: systemctl --user status hermes-gateway

Variáveis de ambiente em config.yaml: Use ${VAR_NAME} para referenciar env vars. Exemplo: api_key: ${OPENROUTER_API_KEY}. Múltiplas referências por valor são suportadas: url: "${HOST}:${PORT}".

05

Modelos e Provedores

Iniciante

Hermes funciona com qualquer modelo. Troque com hermes model — sem mudar código, sem lock-in.

Recomendado

`Nous Portal`

OAuth nativo. 300+ modelos + Tool Gateway (web, image gen, TTS, browser, terminal cloud). Um login cobre tudo.

Popular

`OpenRouter`

200+ modelos via API key. Suporta quase todos os LLMs do mercado.

Local

`Ollama / vLLM`

Modelos locais via endpoint OpenAI-compatible. Zero dados para a nuvem.

Provedores suportados

Provedor	Auth	Notas
Nous Portal	OAuth	Nativo, Tool Gateway incluso
OpenRouter	API key	200+ modelos
OpenAI	API key	GPT-5.5, GPT-5.5 Pro, GPT-5.3 Codex
Anthropic	API key	Claude Opus/Sonnet/Haiku 4.x
NVIDIA NIM	API key	Nemotron models
Hugging Face	API key	Modelos open-source
Kimi / Moonshot	API key	Modelos chineses
MiniMax	API key	Modelos asiáticos
Xiaomi MiMo	API key	Modelos chineses
z.ai / GLM	API key	ChatGLM family
DeepSeek	API key	DeepSeek V4 Pro, V4 Flash
Qwen / Alibaba	API key	Qwen3.7-Max, Qwen3.6 family
xAI / SuperGrok	OAuth	Grok 4.3 via SuperGrok OAuth
Google / Gemini	API key	Gemini 3 Pro/Flash, 3.1 Flash Lite
NovitaAI	API key	Cloud GPU + API
Custom endpoint	URL + key	Qualquer API OpenAI-compatible

Trocar modelo

hermes model

Wizard interativo para escolher provedor e modelo

Trocar mid-session

/model anthropic/claude-sonnet-4.6

Muda modelo sem reiniciar. --global persiste no config.yaml

Nous Portal: Um OAuth cobre inferência + Tool Gateway (web search, image gen, TTS, browser, terminal cloud opcional). Configure backends por ferramenta com hermes tools — não é tudo-ou-nada. Modelos agentic recomendados: claude-sonnet-4.6, gpt-5.5-pro, gemini-3-pro-preview.

Hermes 4: Os modelos Hermes-4-70B/405B do Portal são ótimos para chat, mas não são recomendados dentro do agent loop — prefira modelos agentic do catálogo.

06

Ferramentas e Toolsets

Intermediário

Hermes tem 40+ ferramentas built-in organizadas em toolsets. Habilite/desabilite por plataforma ou sessão.

Categoria	Ferramentas	Descrição
Web	`web_search`, `web_extract`	Busca na web e extrai conteúdo de páginas
X Search	`x_search`	Busca posts do X/Twitter via xAI (requer credenciais)
Terminal	`terminal`, `process`	Executa comandos shell e gerencia processos background
Arquivos	`read_file`, `patch`, `write_file`, `search_files`	Leitura, edição, criação e busca de arquivos
Browser	`browser_navigate`, `browser_snapshot`, `browser_click`, `browser_vision`	Automação de browser com texto e visão
Mídia	`vision_analyze`, `image_generate`, `text_to_speech`	Análise de imagens, geração de imagens, TTS
Orquestração	`todo`, `clarify`, `execute_code`, `delegate_task`	Planejamento, clarificação, execução de código, subagentes
Memória	`memory`, `session_search`	Memória persistente e busca em sessões passadas
Automação	`cronjob`, `send_message`	Tarefas agendadas e envio de mensagens
Integrações	`ha_*` (Home Assistant), MCP tools	Smart home e servidores MCP

Ver toolsets disponíveis

hermes tools

Iniciar com toolsets específicos

hermes chat --toolsets "web,terminal"

Toolsets comuns: web, search, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant, messaging, rl. MCP servers dinâmicos aparecem como mcp-<server>.

07

Skills System

Intermediário

Skills são memórias procedurais que o agente cria, reusa e melhora automaticamente. Formato aberto agentskills.io — portátil entre instâncias.

Skills built-in

MLOps, GitHub flows, research workflows
Diagramming, note-taking, data science
Bundle default enxuto na v0.16 — skills extras via hermes skills install
Hubs: agentskills.io, NVIDIA/skills, ClawHub, GitHub

Criar skill automaticamente

Após tarefas complexas, o agente pode auto-gerar uma skill. Ela é salva em ~/.hermes/skills/ como SKILL.md.

hermes skills

Estrutura de uma Skill (SKILL.md)

---
name: seo-audit
description: Realiza auditoria SEO completa de um site
metadata:
  author: Andre Costa
  category: marketing
  tags: [seo, audit, web]
---

# SEO Audit

## Quando usar
Quando o usuário pedir "audite o SEO do site X" ou similar.

## Passos
1. Use web_search para verificar indexação
2. Use browser_navigate para checar mobile-friendliness
3. Use web_extract para analisar meta tags
4. Compile relatório com findings e recomendações

## Saída
Relatório markdown com: index status, mobile score, meta analysis, recommendations.

Gerenciar skills

hermes skills

hermes bundles

Bundles agrupam skills sob um único comando slash

Curadoria automática

hermes curator

Manutenção em background das skills — melhora, consolida e remove obsoletas

Self-improvement: O agente analisa padrões de execução, identifica gargalos e sugere otimizações. Se chamadas repetidas a uma API causam latência, a skill pode ser auto-otimizada com connection reuse, batching async ou caching.

08

Memória Persistente

Intermediário No meu fluxo

Hermes não reseta a cada conversa. Ele lembra projetos, preferências, erros passados e melhora com o tempo — o coração do "sistema que cresce comigo".

Tipos de memória

Working memory — contexto da sessão atual
Episodic memory — registros de tarefas passadas (SQLite + FTS5)
Semantic memory — conhecimento consolidado sobre você e seus projetos
Honcho (plugin opcional) — perfil dialético do usuário via hermes plugins

Busca cross-session

session_search

FTS5 full-text search + LLM summarization para encontrar conversas passadas

Ferramenta memory

memory(action="add", target="user", content="Prefere commits em português")

memory(action="add", target="memory", content="Projeto usa Next.js 14 + Tailwind")

Target user = perfil do usuário. Target memory = notas gerais. O agente recebe nudges periódicos para persistir conhecimento.

Learning loop: Após cada tarefa, o agente escreve um registro estruturado do que tentou, do que funcionou e do que falhou. Em tarefas futuras similares, recupera esses registros e ajusta a abordagem antes de executar. No meu fluxo isso acumula skills de "auditoria de sites de clientes" automaticamente — 3 meses depois ele propõe variações do método que eu nem tinha escrito.

08.5

Como eu vejo crescer

Intermediário Meu sistema

O Hermes não é estático. No meu fluxo, ele é o "sistema que cresce comigo" — memória persistente + skills auto-geradas + cron + subagentes viram o loop vivo do meu método de 5 etapas. Ralph (o goal loop) + "melhorar" repetido acumula autonomia real. Veja exemplos reais da minha prática de mentoring e produção.

Skills que nasceram sozinhas

Após 4 auditorias SEO seguidas, o agente gerou seo-audit + mentor-gate-check (portão humano obrigatório antes de commit de cliente). Eu só revisei o SKILL.md. Hoje uso via /seo-audit e ensino isso na trilha do blog.

hermes skills list

Memória que persiste e evolui

Meu USER.md tem 18 meses de preferências de tom + arquitetura. O agente agora antecipa: "como no projeto X de 2025, usei contexto comprimido aqui". O loop de Ralph /goal refatorar-auth rodou 11 dias em paralelo e entregou 3 variações do método que eu apliquei em mentorias.

/goal status

O que mudou na minha prática (crescimento visível)

2025 Q3: 1 skill manual por semana. Hoje: 2-3 auto por mês + curator melhora as antigas.
Contexto: Antes 12k tokens por sessão complexa. Agora <4k porque memória + /compress do método + skills condensam.
Autonomia: Em mentorias, mostro o log de "melhorar loop" rodando sozinho — o aluno vê o sistema evoluir sem eu intervir. Isso é o 5º passo do método materializado.
Trilha: Tudo que acumulo vira post ou guia (ex: MCP, context engineering). O hermesagent é o artefato vivo do que ensino em /blog/ e home/#metodo.

O agente cresce porque eu uso o método ritual todos os dias. Você instala o mesmo, roda o loop, e ele cresce com você. Veja o método completo • Comece a Trilha de Autonomia

Por que isso importa: Skills + memória + cron não são features isoladas. São o motor do "cresce comigo". Sem o método (diagnosticar → melhorar), vira só chat chique. Com o método vira sistema vivo — exatamente o que eu uso e ensino.

09

Automações Agendadas (Cron)

Intermediário

Scheduler built-in que executa o agente em horários definidos. O gateway entrega resultados em qualquer plataforma conectada.

Criar tarefa (linguagem natural)

"Todo dia às 8h, envie no Telegram o clima de São Paulo e meus eventos do dia"

O agente interpreta e cria o cron job automaticamente

Criar tarefa (sintaxe cron)

0 8 * * 1-5

Dias de semana às 8h. Use crontab.guru para traduzir.

Gerenciar tarefas

hermes cron list

hermes cron pause <job_id>

hermes cron resume <job_id>

hermes cron remove <job_id>

hermes cron run <job_id>

O gateway verifica a cada 60 segundos se há jobs devidos. Quando dispara, o agente executa com todas as tools, memória e skills — e entrega o resultado na plataforma configurada.

Requisito: O scheduler vive dentro do gateway. Para tarefas rodarem quando você não está online, instale o gateway como serviço: hermes gateway install (systemd no Linux, serviço no Windows).

10

Messaging Gateway

Intermediário

Um único gateway conecta Hermes a 20+ plataformas. Mesmo agente, mesma memória, todas as superfícies.

Plataformas suportadas

CLI Telegram Discord Slack WhatsApp Signal Matrix Mattermost Email SMS Microsoft Teams Google Chat LINE ntfy DingTalk Feishu WeCom Weixin QQ Bot Yuanbao BlueBubbles Home Assistant

Configurar gateway

hermes gateway setup

Wizard interativo para cada plataforma

Iniciar gateway

hermes gateway

hermes gateway start

Foreground: hermes gateway. Serviço persistente: install → start. Linux VPS: sudo loginctl enable-linger $USER.

Produção: Por padrão, usuários não autorizados são negados. Configure allowlists em ~/.hermes/.env ou use DM pairing: hermes pairing approve <platform> <código>.

Cross-platform continuity: Comece uma conversa no Telegram, continue no CLI. O agente mantém o mesmo session_id e histórico. Use /handoff telegram no CLI (requer gateway rodando + /sethome no destino).

11

Delegação e Subagentes

Avançado

Isole tarefas paralelas em subagentes com conversas, terminais e contexto próprios. Zero custo de contexto entre eles.

Subagente via comando

/background "pesquise sobre X"

Executa em sessão isolada. Resultado aparece como painel quando termina.

Subagente via código

delegate_task(goal="...", toolsets=["web"])

Chama programmaticamente via Python RPC. Útil em scripts e pipelines.

execute_code — colapsar pipelines

from hermes_tools import web_search, terminal, read_file

# Busca, processa e retorna em uma única tool call
results = web_search(query="Hermes Agent Nous Research")
for r in results["data"]["web"][:3]:
    print(r["title"], r["url"])

Scripts Python podem chamar tools via RPC. Multi-step pipelines colapsam em uma única inference call — economia massiva de tokens.

Parallel workstreams: Subagentes rodam em paralelo com conversas isoladas. Cada um tem seu próprio terminal backend, modelo e skills. Use para: research em background, análise de múltiplos arquivos simultaneamente, testes paralelos.

12

Execution Backends (Sandbox)

Intermediário

6 backends de execução. Escolha conforme necessidade de segurança, isolamento e infraestrutura.

Backend	Descrição	Use quando
`local`	Executa na máquina local (padrão)	Desenvolvimento, tarefas confiáveis
`docker`	Container isolado com hardening	Segurança, reprodutibilidade
`ssh`	Execução remota via SSH	Agente não pode modificar seu próprio código
`singularity`	Containers HPC (rootless)	Cluster computing, HPC
`modal`	Serverless cloud	Serverless, escala automática
`daytona`	Remote dev environment	Ambientes de dev persistentes na nuvem

Configurar backend

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: python:3.11-slim
  timeout: 180
  cwd: "."

SSH é recomendado para segurança — o agente não pode modificar seu próprio código se executa em outra máquina.

Serverless persistence: Modal e Daytona hibernam quando idle e acordam on-demand. Custo próximo de zero quando não está em uso. Ideal para agentes 24/7 sem manter VPS ligado.

13

MCP Integration

Intermediário

Model Context Protocol — conecte servidores MCP para estender as capacidades do Hermes com ferramentas externas.

Gerenciar MCPs

hermes mcp

Lista, adiciona, remove e configura servidores MCP

Recarregar MCPs

/reload-mcp

Recarrega servidores MCP sem reiniciar sessão

MCPs populares

Servidor	Instalação	Uso
`filesystem`	`npx -y @modelcontextprotocol/server-filesystem /path`	Acesso a arquivos fora do working directory
`fetch`	`uvx mcp-server-fetch`	Requisições HTTP genéricas
`git`	`npx -y @modelcontextprotocol/server-git`	Operações git avançadas
`postgres`	`npx -y @modelcontextprotocol/server-postgres`	Consultas SQL PostgreSQL
`sqlite`	`npx -y @modelcontextprotocol/server-sqlite`	Consultas SQLite locais
`puppeteer`	`npx -y @modelcontextprotocol/server-puppeteer`	Automação de browser
`github`	`npx -y @modelcontextprotocol/server-github`	API GitHub (issues, PRs, repos)

Debug: Se um MCP não conectar, verifique: (1) comando no PATH, (2) dependências instaladas, (3) JSON válido. Use hermes mcp para ver logs de erro específicos.

14

Workflows Práticos

Iniciante Intermediário No meu fluxo

Exemplos reais de uso do Hermes Agent no dia a dia. Copie, adapte e execute. No meu fluxo, o workflows + skills + memória viram o "loop vivo" do meu método — e o que ensino na trilha do blog.

🔍 Pesquisa web com análise

Busque informações, extraia páginas e compile relatórios.

Inicie: hermes
Peça: "Pesquise as últimas tendências de IA em 2026 e compile um resumo"
O agente usa web_search + web_extract automaticamente
Para páginas complexas: "Abra https://example.com e extraia a tabela de preços"

hermes chat -q "Pesquise tendências de IA generativa 2026 e compile resumo em português" --toolsets "web"

🤖 Automação diária (Morning Briefing)

Configure um briefing matinal automático no Telegram.

Configure gateway: hermes gateway setup → escolha Telegram
Inicie gateway: hermes gateway
Diga ao agente: "Todo dia às 8h, envie no Telegram: clima de São Paulo, headlines de tech, e meus eventos do Google Calendar"
Verifique: hermes cron list

hermes cron list

📝 Criar uma skill do zero

Crie uma skill para automatizar tarefas recorrentes.

Crie o diretório: mkdir -p ~/.hermes/skills/seo-audit
Crie ~/.hermes/skills/seo-audit/SKILL.md com trigger, steps e output
Recarregue: /reload
Use: /seo-audit https://meusite.com

🐛 Debug com terminal

Use o agente para investigar erros e executar comandos.

Compartilhe o erro: "Estou vendo um erro ao rodar npm test"
O agente executa terminal para investigar
Forneça stack trace ou peça: "Rode os testes e me diga qual está falhando"
Solicite correção: "Corrija o bug no arquivo user.ts"

hermes chat -q "Rode npm test, identifique o bug e corrija" --toolsets "terminal,file"

🚀 Deploy com subagente

Delegue tarefas de deploy para um subagente isolado.

No CLI principal: /background "Faça deploy para produção: rode testes, build, e deploy na Vercel"
Continue trabalhando enquanto o subagente processa
Resultado aparece como painel quando termina

/background "Rode testes, faça build, e deploy na Vercel. Reporte o URL."

📈 Meu briefing de crescimento (Ralph loop na prática)

No meu fluxo: toda manhã o agente consolida o que "cresceu" sozinho via memória + skills auto + cron. Isso é o 5º passo do método (melhorar) rodando 24/7.

Configurei um cron natural: "Todo dia às 7h30, leia minhas memórias das últimas 48h, summarize skills novas geradas, e envie no Telegram com 1 insight do método que posso aplicar hoje"
O agente usa memory + session_search + skills curator automaticamente
Resultado: vejo o sistema evoluindo sem esforço — ex: ele detectou padrão de "portão humano" em 3 projetos e sugeriu skill "mentor-gate-check"

hermes cron list # ou /cron no chat

Isso é o que conecta o Hermes ao meu método ritual e à Trilha de Autonomia que publico no blog. O agente não é ferramenta — é o relógio do meu loop que cresce.

15

Segurança

Avançado Produção

Hermes tem acesso a terminal e arquivos. Antes de expor o gateway em Telegram/Discord, configure estas camadas — a doc oficial trata segurança como prioridade #1 em produção.

Camada	O que protege	Como configurar
Autorização	Quem pode falar com o bot	`TELEGRAM_ALLOWED_USERS` no `.env` ou `hermes pairing approve`
Aprovação de comandos	Operações destrutivas no shell	`approvals.mode: manual\|smart\|off` em config.yaml
Sandbox	Isolamento de execução	`terminal.backend: docker\|modal\|daytona`
Slash commands	O que usuários não-admin podem rodar	`user_allowed_commands` em gateway-config.yaml
Blocklist hardline	Comandos catastróficos (rm -rf /, fork bomb)	Sempre ativo — nem `--yolo` contorna

DM Pairing (recomendado)

Usuários desconhecidos recebem um código de 8 caracteres. Você aprova no CLI:

hermes pairing approve telegram ABC12DEF

hermes pairing list

Modos de aprovação

# ~/.hermes/config.yaml
approvals:
  mode: manual    # manual | smart | off
  timeout: 60
  cron_mode: deny # deny | approve (headless)

smart usa LLM auxiliar para auto-aprovar baixo risco. off = equivalente a YOLO permanente.

YOLO (--yolo / /yolo): Pula aprovações de comandos perigosos na sessão. Use só em ambientes descartáveis (CI, containers). Em produção com gateway, combine allowlists + Docker backend.

Docker em produção: Com terminal.backend: docker, checks de comando perigoso são ignorados dentro do container — o isolamento vira a fronteira de segurança. Veja também hermes security audit para auditoria de supply-chain.

16

Troubleshooting

Iniciante Intermediário

Erros comuns e como resolver. Use hermes doctor para diagnóstico automático.

`hermes: command not found`

O binário não está no PATH. Recarregue o shell:

source ~/.bashrc

Ou adicione export PATH="$HOME/.hermes/bin:$PATH" ao seu .bashrc/.zshrc.

Auth falha / modelo não responde

Verifique credenciais e provedor:

hermes status

hermes portal info

hermes auth add nous

Token OAuth expirado? Re-autentique com hermes auth add nous ou hermes setup --portal.

Gateway não recebe mensagens

Verifique passo a passo:

O gateway está rodando? hermes gateway status ou systemctl --user status hermes-gateway
As credenciais da plataforma estão configuradas? hermes gateway setup
Seu user ID está na allowlist ou foi aprovado via pairing?
O bot foi adicionado ao canal/grupo?

Contexto muito grande / respostas lentas

Comprima ou limpe o contexto:

/compress mantenha apenas decisões

/clear

Use /background para pesquisas extensas — elas rodam em contexto isolado.

Skill não aparece no autocomplete

Verifique:

O arquivo está em ~/.hermes/skills/<nome>/SKILL.md?
O frontmatter YAML está válido? (delimitadores ---)
Recarregue: /reload ou reinicie o Hermes
Use hermes skills para ver skills registradas

MCP não conecta

Verifique:

O comando do MCP está no PATH? Teste no terminal.
Dependências instaladas? (Node.js, uv, Python)
Use hermes mcp para ver logs de erro específicos.

Sessão travou / não responde

Interrompa com Esc ou Ctrl+C. Se persistir:

hermes --continue

Atualize: hermes update. Se recorrente, use hermes debug para enviar logs ao suporte.

17

Hermes Desktop App

Iniciante

Lançado no v0.16.0 — app nativo Electron para macOS, Linux e Windows. Interface gráfica completa sem abrir o terminal.

Instalação

Download do instalador oficial:

https://hermes-agent.nousresearch.com/

Instaladores diretos: .dmg (macOS), .exe (Windows), ou hermes desktop via CLI. One-click install, in-app self-update.

Features principais

Cmd+K palette — comandos rápidos
Session archive/search — busca em conversas
Status-bar model picker — troca modelo em 1 clique
Drag-and-drop + clipboard paste — imagens
Remote gateway — connect via WebSocket
Tradução i18n — Simplified Chinese

Comandos CLI relacionados

hermes desktop

Inicia o app Desktop

hermes dashboard

Abre o Admin Panel web

Remote Gateway: Conecte-se a um gateway remoto via WebSocket seguro (OAuth ou user/pass). Per-profile hosts e cross-profile @session links.

18

Voice Mode

Intermediário

Converse com o Hermes por voz em tempo real. Disponível em CLI, Telegram, Discord e Discord VC.

Ativar no CLI

/voice on

Toggle voice mode. Gravação: Ctrl+B para iniciar/parar.

Plataformas suportadas

CLI — Ctrl+B para gravar
Telegram — voice memos
Discord — voice channel
Discord VC — real-time voice chat

Configuração

# ~/.hermes/config.yaml
voice:
  enabled: true
  provider: openai  # ou edge, elevenlabs
  language: pt-BR

TTS: Text-to-speech incluso no Tool Gateway do Nous Portal. Sem API keys separadas. Suporta múltiplos providers: OpenAI, Edge (gratuito), ElevenLabs.

19

Context Files — SOUL.md & AGENTS.md

Avançado

Arquivos de contexto que moldam a identidade e o comportamento do agente em cada conversa. O coração do self-improvement loop.

SOUL.md — Identidade global

Define a personalidade, tom e valores padrão do agente. Aplica-se a todas as sessões.

# ~/.hermes/SOUL.md
Você é um assistente técnico direto e prático.
Prefira código funcional sobre explicações longas.
Sempre valide com screenshots antes de declarar "done".

AGENTS.md — Contexto de projeto

Define regras específicas do projeto atual. O agente lê automaticamente quando está no diretório.

# ./AGENTS.md (raiz do projeto)
Este projeto usa Eleventy + Nunjucks.
Commits: conventional commits em português.
Deploy: Vercel, build output em public/.
Nunca comite public/.

Flags relacionadas

hermes --ignore-rules

Ignora SOUL.md e AGENTS.md para sessão

/personality

Define personalidade predefinida mid-session

Learning loop: O agente analisa padrões de execução e sugere melhorias para SOUL.md e AGENTS.md. Após tarefas complexas, ele pode auto-gerar atualizações para manter o contexto sempre atualizado.

Hermes Agent — o agente que cresce comigo

Terminal (Linux/macOS/WSL)

Desktop App (macOS / Windows / Linux)

Instalação

Linux / macOS / WSL2 / Termux

Windows (PowerShell nativo)

Após instalar

Comandos CLI

Slash Commands

Configuração

Estrutura do ~/.hermes/

Ver configuração

Editar configuração

Set valor específico

Verificar config

Exemplo de config.yaml

Modelos e Provedores

Nous Portal

OpenRouter

Ollama / vLLM

Provedores suportados

Trocar modelo

Trocar mid-session

Ferramentas e Toolsets

Ver toolsets disponíveis

Iniciar com toolsets específicos

Skills System

Skills built-in

Criar skill automaticamente

Estrutura de uma Skill (SKILL.md)

Gerenciar skills

Curadoria automática

Memória Persistente

Tipos de memória

Busca cross-session

Ferramenta memory

Como eu vejo crescer

Skills que nasceram sozinhas

Memória que persiste e evolui

O que mudou na minha prática (crescimento visível)

Automações Agendadas (Cron)

Criar tarefa (linguagem natural)

Criar tarefa (sintaxe cron)

Gerenciar tarefas

Messaging Gateway

Plataformas suportadas

Configurar gateway

Iniciar gateway

Delegação e Subagentes

Subagente via comando

Subagente via código

execute_code — colapsar pipelines

Execution Backends (Sandbox)

Configurar backend

MCP Integration

Gerenciar MCPs

Recarregar MCPs

MCPs populares

Workflows Práticos

🔍 Pesquisa web com análise

🤖 Automação diária (Morning Briefing)

📝 Criar uma skill do zero

🐛 Debug com terminal

🚀 Deploy com subagente

📈 Meu briefing de crescimento (Ralph loop na prática)

Segurança

DM Pairing (recomendado)

Modos de aprovação

Troubleshooting

hermes: command not found

Auth falha / modelo não responde

Gateway não recebe mensagens

Contexto muito grande / respostas lentas

Skill não aparece no autocomplete

MCP não conecta

Sessão travou / não responde

Hermes Desktop App

Instalação

Features principais

Comandos CLI relacionados

`Nous Portal`

`OpenRouter`

`Ollama / vLLM`

`hermes: command not found`