Dein 7-Uhr-Cron-Brief liest sich wie eine Systemmeldung — zwei Schalter reichen


Jeden Morgen landet ein Brief in Telegram: wie viele PRs gestern gemergt wurden, ob der Build durchgelaufen ist, was auf deine Entscheidung wartet. Der Inhalt ist in Ordnung. Der erste Bildschirm nicht:

Cronjob Response: Morning brief
(job_id: 8322078a1a06)
-------------

12 PRs merged yesterday...

Vier Zeilen Boilerplate fressen die Notification-Preview und lassen das Ganze wie eine Systemmeldung aussehen, die man getrost ignorieren kann. Und scrollst du nach unten, kommt noch eine Zeile, die erklärt, wie man den Job stoppt.

Das Format ist das kleine Problem. Das größere zeigt sich in dem Moment, in dem du antwortest: „Was war der dritte PR?“ Der Agent hat keine Ahnung, wovon du sprichst, weil diese Nachricht nie Teil des Gesprächs war — sie war eine Einbahnstraßen-Notification.

Beide Probleme haben ihren eigenen Schalter, und beide gelten pro Job.

Schalter eins: die Ausgabe nicht mehr einpacken

Der Wrapper ist global standardmäßig an, unter cron.wrap_response. Ist er an, wird jede Zustellung so angezogen:

Cronjob Response: <job name>
(job_id: <job id>)
-------------

<the actual content>

To stop or manage this job, send me a new message (e.g. "stop reminder <job name>").

Für ein einmaliges „erinnere mich in 20 Minuten an die Pasta“ ist das wirklich nützlich: Du musst wissen, wie du es abbrechen kannst. Für einen Brief, der jeden Tag zur selben Zeit kommt, ist es nur Rauschen.

Jetzt kannst du es pro Job überschreiben:

# gleich sauber anlegen
hermes cron create "0 7 * * *" "Summarize yesterday's PRs and build status in under 200 words." \
  --name "Morning brief" --no-wrap-response

# einen bestehenden Job reparieren
hermes cron edit 8322078a1a06 --no-wrap-response

# zurück zum globalen Standard (der true ist)
hermes cron edit 8322078a1a06 --inherit-wrap-response

Die drei Flags sind genau das, wonach sie klingen: --wrap-response erzwingt den Wrapper, --no-wrap-response schaltet ihn ab, und --inherit-wrap-response entfernt die Überschreibung dieses Jobs, sodass er wieder cron.wrap_response folgt. Das letzte ist nach dem Experimentieren wichtig: Es löscht das Feld, statt ein false stehen zu lassen, damit eine spätere Änderung am globalen Standard den Job auch wirklich erreicht.

Wenn jeder Brief auf der Maschine sauber sein soll, stell es global:

cron:
  wrap_response: false

Das gilt für bestehende und künftige Jobs; ein Job mit expliziter Einstellung gewinnt weiterhin.

Schalter zwei: Rückfragen bekommen ihren eigenen Thread

Eine Notification ist fire-and-forget. Damit ein Brief etwas ist, in das du hineinantworten kannst, muss der Job fortsetzbar sein:

cron:
  mirror_delivery: true    # Zustellungen landen in der History des Zielgesprächs

oder, für einen einzelnen Job:

hermes cron edit 8322078a1a06 --attach-to-session

Mit dem Schalter an ist das Verhalten thread-bevorzugt:

  • Thread-fähige Plattformen (Telegram-Forentopics, Discord-, Slack-, Matrix-Threads): Jede Zustellung öffnet einen eigenen Thread, und der Brief wird in die Session dieses Threads gelegt — eine Antwort läuft also mit dem vollen Brief im Kontext weiter.
  • DM-only-Plattformen (WhatsApp, Signal, SMS): Es gibt keine Threads, also wird der Brief in die Ziel-DM-Session gespiegelt und die DM selbst ist die Fläche für die Fortsetzung.
  • Die Spiegelung wird als gekennzeichneter User-Turn geschrieben, [Cron delivery: <job name>], was die History lesbar hält und die Turn-Alternation bei allen Providern legal.

Ein Detail bringt Leute regelmäßig zum Stolpern: Ein Job, der in einem Telegram-Topic angelegt wurde, liefert weiter genau in dieses Topic, weil sein Ursprung das Ziel pinnt. Genau das will ein wiederkehrender Brief nicht — sonst teilen sich die Rückfrage von gestern und der Brief von heute einen Thread, und „was war mit dem zweiten?“ ist mehrdeutig.

Für diese Jobs gibt es einen Schalter auf Plattformebene:

platforms:
  telegram:
    extra:
      cron_fresh_thread_per_run: true

Er betrifft nur Zustellungen zurück in das eigene Topic des Jobs; ein explizit gesetztes Ziel chat_id:thread_id wird nie überschrieben. Discord ist die Ausnahme: Es kann keinen Thread in den Thread des Jobs verschachteln, ein in einem Discord-Thread angelegter Job liefert also weiterhin dorthin.

Nebenbei: zwei Stellschrauben für das Timing

Zwei weitere Per-Job-Einstellungen erklären die meisten Fragen der Art „warum kam mein Brief heute nicht“.

catch_up: was mit Läufen passiert, die verpasst wurden, während die Maschine aus war. --catch-up on holt den verpassten Termin bei der Rückkehr einmal nach; off überspringt ihn und bucht ihn als missed-Zeile in hermes cron runs. Der Standard folgt bei wiederkehrenden Jobs cron.catch_up_missed (true), One-Shots überspringen — eine Erinnerung „in 20 Minuten“ ist zwei Stunden später wertlos.

grace_minutes: wie spät ein Lauf sein darf. Das Standardfenster ist die halbe Periode, begrenzt auf 2–120 Minuten. --grace-minutes 0 ist ein echter Wert und kein „nicht gesetzt“: Es wird nie nachgeholt, ein verpasster Termin wird also übersprungen statt verspätet ausgeführt. Ein nächtlicher Job, der auch dann laufen muss, wenn das Laptop spät aufwacht, lässt sich bis 1440 Minuten (ein Tag) aufweiten.

--timezone: in welcher Wanduhr der Cron-Ausdruck gelesen wird. Lässt du sie weg, gilt die Zone des Profils. Der klassische Bug, den das behebt, ist „ich habe definitiv 9 Uhr geschrieben“ — geschrieben in einer Zone, die du nicht gemeint hast.

Ein durchkonfiguriertes Beispiel

Zusammengesetzt sieht ein sauberer, ansprechbarer 7-Uhr-Brief für Hongkong so aus:

hermes cron create "0 7 * * *" \
  "Collect yesterday's PRs, build and deploy results into a brief under 200 words; if nothing is wrong, say so in one line." \
  --name "Morning brief" \
  --timezone Asia/Hong_Kong \
  --no-wrap-response \
  --attach-to-session \
  --catch-up on

und in config.yaml ein frischer Thread pro Lauf auf Telegram:

platforms:
  telegram:
    extra:
      cron_fresh_thread_per_run: true

Das Ergebnis: ein sauberer Brief im eigenen Thread um 7 Uhr, und wenn du „wer hat den dritten PR gemergt?“ antwortest, weiß der Agent, welchen Brief und welchen Punkt du meinst.

Kanten, die du kennen solltest

  • Der Wrapper abzuschalten ändert nichts an der Zustellung selbst — Ziel, Fehlermeldungen und Retries bleiben unberührt; nur die Textdekoration fällt weg.
  • Fehlermeldungen haben ihren eigenen Schalter. failure_deliver leitet Fehlernachrichten woandershin, und local unterdrückt sie ganz, während der Fehlschlag weiterhin in hermes cron list und hermes cron runs steht.
  • Fortsetzbar ist nicht „eine endlose Session“. Threads gelten pro Lauf, Historien pro Thread. Wenn ein Job seine eigene frühere Ausgabe über Läufe hinweg sehen soll, ist das --continuity — ein anderes Feature, nicht verwechseln.
  • Nicht jedes Ziel kann fortsetzbar sein. Broadcast-Erweiterungen (deliver: all) werden nie gespiegelt, weil das gleich mehrere Gespräche auf einmal umschreiben würde.

Wenn dein Cron-Setup generell bockt, fang mit hermes cron doctor an; wenn du einen Job willst, der sich merkt, was er letztes Mal berichtet hat, lies Cron-Memory-Continuity. Die vollständige Flag-Liste steht in der hermes cron-Referenz, und diese Änderung ist in v0.23.2 gelandet.

Die Kurzfassung

Ob ein Brief wie eine Systemmeldung oder wie eine Nachricht von einer Kollegin wirkt, entscheidet sich an zwei Schichten: Der Wrapper (wrap_response) bestimmt, wie er aussieht, und die fortsetzbare Zustellung (attach_to_session, plus ein frischer Thread pro Lauf) bestimmt, ob du darauf antworten kannst. Beides ist ein Flag pro Job, beides dauert unter einer Minute, und beides zahlt sich jeden einzelnen Morgen aus.