Comando hermes send — Referência Completa e Exemplos

Visão geral

hermes send envia texto de qualquer script shell para uma plataforma de mensagens que já esteja configurada no Hermes. Ele reutiliza as credenciais da plataforma do gateway (~/.hermes/.env e ~/.hermes/config.yaml). Sem LLM, sem loop de agente, e sem necessidade de gateway em execução para plataformas com bot token como Telegram, Discord, Slack ou Signal.

hermes send [-t TARGET] [-f PATH] [-s LINE] [-l] [-q] [--json] [message]

Opções

Opção	Descrição
`message`	Texto da mensagem. Se omitido, lido de `--file` ou stdin.
`-t TARGET`, `--to TARGET`	Destino da entrega. Formatos: `platform`, `platform:chat_id`, `platform:chat_id:thread_id` ou `platform:#channel-name`.
`-f PATH`, `--file PATH`	Lê o corpo da mensagem de `PATH`. Use `-` para stdin.
`-s LINE`, `--subject LINE`	Adiciona uma linha de assunto/cabeçalho antes do corpo da mensagem.
`-l`, `--list`	Lista os destinos disponíveis. Filtro opcional: `hermes send --list telegram`.
`-q`, `--quiet`	Suprime a saída padrão em caso de sucesso (apenas código de saída).
`--json`	Emite o resultado bruto em JSON em vez de formato legível.

Exemplos

# Enviar uma mensagem simples
hermes send --to telegram "deploy finished"

# Enviar a partir de um pipe
echo "RAM 92%" | hermes send --to telegram:-1001234567890

# Enviar o conteúdo de um arquivo
hermes send --to discord:#ops --file /tmp/report.md

# Adicionar uma linha de assunto
hermes send --to slack:#eng --subject "[CI]" --file build.log

# Enviar uma mídia como anexo
hermes send --to telegram "MEDIA:/tmp/chart.png"

Cenários comuns

Notificação de CI/CD

hermes send --to telegram "Build passed on $(date)"

Alerta de cron job

echo "Nightly backup completed" | hermes send --to discord:#ops

Listar destinos

hermes send --list
hermes send --list telegram

Códigos de saída

0 — entrega bem-sucedida
1 — erro de entrega ou backend
2 — erro de uso

Dicas

Use MEDIA:/caminho/para/arquivo no texto da mensagem para anexar uma imagem ou documento.
O formato do destino varia por plataforma; use --list para ver os destinos disponíveis.
Use --quiet em scripts para não poluir a saída padrão.
Use --json ao encadear hermes send com outras ferramentas de automação.