Commande hermes send — Référence Complète & Exemples

Vue d’ensemble

hermes send envoie du texte depuis n’importe quel script shell vers une plateforme de messagerie déjà configurée pour Hermes. Il réutilise les identifiants de la plateforme du gateway (~/.hermes/.env et ~/.hermes/config.yaml). Pas de LLM, pas de boucle d’agent, et aucun gateway en cours d’exécution n’est requis pour les plateformes à bot token comme Telegram, Discord, Slack ou Signal.

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

Options

Option	Description
`message`	Texte du message. S’il est omis, lu depuis `--file` ou stdin.
`-t TARGET`, `--to TARGET`	Cible de livraison. Formats : `platform`, `platform:chat_id`, `platform:chat_id:thread_id` ou `platform:#channel-name`.
`-f PATH`, `--file PATH`	Lit le corps du message depuis `PATH`. Utilisez `-` pour stdin.
`-s LINE`, `--subject LINE`	Ajoute une ligne de sujet/en-tête avant le corps du message.
`-l`, `--list`	Liste les cibles disponibles. Filtre optionnel : `hermes send --list telegram`.
`-q`, `--quiet`	Supprime la sortie standard en cas de succès (code de sortie uniquement).
`--json`	Émet le résultat brut JSON au lieu d’une sortie lisible.

Exemples

# Envoyer un message simple
hermes send --to telegram "deploy finished"

# Envoyer depuis un tube
echo "RAM 92%" | hermes send --to telegram:-1001234567890

# Envoyer le contenu d'un fichier
hermes send --to discord:#ops --file /tmp/report.md

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

# Envoyer une pièce jointe multimédia
hermes send --to telegram "MEDIA:/tmp/chart.png"

Scénarios courants

Notification CI/CD

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

Alerte de tâche cron

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

Lister les cibles

hermes send --list
hermes send --list telegram

Codes de sortie

0 — livraison réussie
1 — erreur de livraison ou backend
2 — erreur d’utilisation

Conseils

Utilisez MEDIA:/chemin/vers/fichier dans le texte du message pour joindre une image ou un document.
Le format de la cible varie selon la plateforme ; utilisez --list pour voir les cibles disponibles.
Utilisez --quiet dans les scripts pour ne pas polluer la sortie standard.
Utilisez --json lorsque vous enchaînez hermes send avec d’autres outils d’automatisation.