hermes send Befehl — Vollständige Referenz & Beispiele

Überblick

hermes send leitet Text aus beliebigen Shell-Skripten an eine Messaging-Plattform weiter, für die Hermes bereits konfiguriert ist. Es nutzt die Gateway-Plattform-Anmeldedaten (~/.hermes/.env und ~/.hermes/config.yaml). Kein LLM, kein Agent-Loop, und für Bot-Token-Plattformen wie Telegram, Discord, Slack oder Signal ist kein laufendes Gateway erforderlich.

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

Optionen

Option	Beschreibung
`message`	Nachrichtentext. Wenn weggelassen, wird aus `--file` oder stdin gelesen.
`-t TARGET`, `--to TARGET`	Ziel. Format: `platform`, `platform:chat_id`, `platform:chat_id:thread_id` oder `platform:#channel-name`.
`-f PATH`, `--file PATH`	Nachrichtentext aus `PATH` lesen. `-` für stdin erzwingen.
`-s LINE`, `--subject LINE`	Betreff-/Header-Zeile vor den Nachrichtentext stellen.
`-l`, `--list`	Verfügbare Ziele auflisten. Optionaler Filter: `hermes send --list telegram`.
`-q`, `--quiet`	Stdout bei Erfolg unterdrücken (nur Exit-Code).
`--json`	Rohes JSON-Ergebnis statt menschenlesbarer Ausgabe ausgeben.

Beispiele

# Einfache Nachricht senden
hermes send --to telegram "deploy finished"

# Aus einem Pipe senden
echo "RAM 92%" | hermes send --to telegram:-1001234567890

# Dateiinhalt als Nachricht senden
hermes send --to discord:#ops --file /tmp/report.md

# Betreffzeile voranstellen
hermes send --to slack:#eng --subject "[CI]" --file build.log

# Medienanhäng senden
hermes send --to telegram "MEDIA:/tmp/chart.png"

Häufige Szenarien

CI/CD-Benachrichtigung

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

Cron-Job-Alarm

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

Ziele auflisten

hermes send --list
hermes send --list telegram

Exit-Codes

0 — Zustellung erfolgreich
1 — Zustell- oder Backend-Fehler
2 — Verwendungsfehler

Tipps

Verwende MEDIA:/pfad/zur/datei im Nachrichtentext, um ein Bild oder Dokument anzuhängen.
Das Zielformat variiert je nach Plattform; nutze --list, um verfügbare Ziele zu sehen.
Verwende --quiet in Skripten, um stdout nicht zu verunreinigen.
Nutze --json, wenn du hermes send mit anderen Automatisierungswerkzeugen verkettest.