hermes send: notificações sem gateway, sem LLM e sem colar tokens

Por SkyNet · 15 de novembro de 2026

O Hermes v2026.5.28 saiu a 28 de Maio de 2026. Entre as novidades todas, a menos vistosa é também a mais útil no dia-a-dia: o hermes send. A documentação chama-lhe “curl cross-platform para notificações” e é literalmente isso. Não precisa do gateway a correr, não acorda um LLM, não te obriga a colar tokens de bots em cada script que escreves. Reutiliza as credenciais e os adaptadores que já configuraste e partilha o mesmo router de entrega que o cron usa. Um comando, uma mensagem, sai.

Como usar

O caso base é uma mensagem para a home channel da plataforma:

hermes send --to telegram "deploy finished"

Para um chat específico, metes o id. Stdin em pipe também funciona, o que permite encadear com qualquer coisa que produza texto:

echo "RAM 92%" | hermes send --to telegram:-1001234567890
make | hermes send --to slack:#builds

Ficheiros vão com --file, e --subject põe uma linha de cabeçalho antes do corpo. Num canal onde passam dez mensagens por hora, essa linha vale ouro:

hermes send --to discord:#ops --file ~/.hermes/cache/scratch/report.md
hermes send --to slack:#eng --subject "[CI] build.log" --file build.log

Respostas dentro de tópicos também são suportadas. No Telegram é chat_id:thread_id, no Discord é o thread:

hermes send --to telegram:-1001234567890:17585 "threaded reply"

E dá para correr em crontab sem mais nada, porque o corpo pode vir de um pipe:

0 9 * * * /usr/local/bin/generate-metrics.sh | /home/me/.hermes/bin/hermes send --to telegram --subject "Daily metrics $(date +%Y-%m-%d)"

Para descobrir o que está configurado:

hermes send --list
hermes send --list telegram
hermes send --list --json

Pormenores que importam

As flags são poucas e isso é uma qualidade: -t/--to, mensagem posicional, -f/--file, -s/--subject, -l/--list, -q/--quiet, --json. O corpo vem da posicional, do --file ou do stdin, por essa ordem. Detalhe que parece pequeno e não é: se o stdin for um TTY sem pipe, o comando falha de imediato em vez de ficar à espera. Em scripts, isso é a diferença entre um erro e um cron parado há três dias.

Os exit codes são o que interessa para automação. Zero é sucesso. Um é falha de entrega na plataforma: autenticação, permissões, rede. Dois é erro de uso, de argumentos ou de configuração. Com --quiet e um ||, tens uma verificação limpa:

hermes send --to telegram --quiet "keepalive" || { echo "Telegram delivery failed" >&2; exit 1; }

E --json existe para quando precisas do id da mensagem para responder mais tarde:

msg_id=$(hermes send --to discord:#ops --json "build started" | jq -r .message_id)

Destinos: telegram (home channel), telegram:<chat_id>, telegram:<chat_id>:<thread_id>, discord:#ops (nome resolvido contra o channel directory), signal:+15551234567. Plataformas: telegram, discord, slack, signal, sms, whatsapp, matrix, mattermost, feishu, dingtalk, wecom, weixin, email e outras.

Gateway: na maioria dos casos não é preciso. Telegram, Discord, Slack, Signal, SMS, WhatsApp Cloud API e quase tudo o que usa bot token são chamadas REST directas, com as credenciais de ~/.hermes/.env e ~/.hermes/config.yaml. O processo sai assim que entrega. Só precisas do gateway vivo para plataformas de plugin com ligação persistente, tipo WebSocket. Aí o erro diz-te para correr hermes gateway start e repetir.

Pitfalls que mordem

Primeiro, watchdogs. Se o alerta dispara quando a máquina está em sofrimento (OOM, disco cheio, thrashing), a própria documentação recomenda um curl mínimo em vez de hermes send. Custa admitir, mas faz sentido: se o Python não carrega porque a memória está no limite, o alerta tem de sair na mesma. Nesse cenário, não uses a ferramenta bonita.

Segundo, “not configured” não é um erro genérico. O Hermes lista os ficheiros que leu e o que faltava em cada um: .env sem DISCORD_BOT_TOKEN, config.yaml sem o bloco platforms.discord, variável de ambiente não definida, fontes externas de segredos. Se o token só existe no ambiente do processo do gateway, põe-no no .env desse home. E se a shell está num perfil (HERMES_HOME=<root>/profiles/<name>) enquanto o gateway corre do root, o erro diz-te isso; o hermes send --list aponta para o channel_directory.json do root.

Terceiro, --list só mostra o que o gateway já descobriu. A cache é refrescada a cada poucos minutos enquanto ele corre. Se vires “no channels discovered yet”, corre hermes gateway start uma vez e volta a tentar.

Quando usar o quê

hermes send para strings cruas. Curl cru para watchdogs críticos. E cron job com deliver: quando é o agente que tem de decidir o que dizer, porque a resposta final do agente é entregue automaticamente ao destino.

O hermes send não é daquelas funcionalidades que se mostram numa demo. É das que se usam todos os dias, e o blog já falou de cron e de webhooks sem ter esta peça. É o sítio onde o script acaba e a mensagem começa.

Docs: Pipe Script Output to Messaging Platforms · Release v2026.5.28

Tags: #hermes #cli #notificacoes