Comando hermes send — Referencia Completa y Ejemplos

Descripción general

hermes send envía texto desde cualquier script de shell a una plataforma de mensajería que Hermes ya tenga configurada. Reutiliza las credenciales de la plataforma del gateway (~/.hermes/.env y ~/.hermes/config.yaml). No requiere LLM, ni bucle de agente, ni gateway en ejecución para plataformas con bot token como Telegram, Discord, Slack o Signal.

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

Opciones

Opción	Descripción
`message`	Texto del mensaje. Si se omite, se lee desde `--file` o stdin.
`-t TARGET`, `--to TARGET`	Destino de entrega. Formatos: `platform`, `platform:chat_id`, `platform:chat_id:thread_id` o `platform:#channel-name`.
`-f PATH`, `--file PATH`	Lee el cuerpo del mensaje desde `PATH`. Usa `-` para stdin.
`-s LINE`, `--subject LINE`	Antepone una línea de asunto/encabezado al cuerpo del mensaje.
`-l`, `--list`	Lista los destinos disponibles. Filtro opcional: `hermes send --list telegram`.
`-q`, `--quiet`	Suprime la salida estándar si tiene éxito (solo código de salida).
`--json`	Emite el resultado en JSON en lugar de formato legible.

Ejemplos

# Enviar un mensaje simple
hermes send --to telegram "deploy finished"

# Enviar desde un pipe
echo "RAM 92%" | hermes send --to telegram:-1001234567890

# Enviar el contenido de un archivo
hermes send --to discord:#ops --file /tmp/report.md

# Anteponer un asunto
hermes send --to slack:#eng --subject "[CI]" --file build.log

# Enviar un archivo adjunto multimedia
hermes send --to telegram "MEDIA:/tmp/chart.png"

Escenarios comunes

Notificación de CI/CD

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

Alerta de trabajo cron

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

Listar destinos

hermes send --list
hermes send --list telegram

Códigos de salida

0 — entrega exitosa
1 — error de entrega o backend
2 — error de uso

Consejos

Usa MEDIA:/ruta/al/archivo en el texto del mensaje para adjuntar una imagen o documento.
El formato del destino varía por plataforma; usa --list para ver los disponibles.
Usa --quiet en scripts para no contaminar la salida estándar.
Usa --json cuando encadenes hermes send con otras herramientas de automatización.