@@ -133,30 +133,44 @@ hermes cron run <job-id>
133133# Example: hermes cron run f8081a091378
134134```
135135
136- Watch the terminal. The agent will:
137- 1 . Load the ` sre-k8s-pod-health ` SKILL.md runbook
138- 2 . Run ` kubectl get pods --all-namespaces ` against your KIND cluster
139- 3 . Print its findings to the terminal
136+ ** How cron execution works:**
140137
141- Expected output shape (from a healthy KIND cluster):
138+ ` hermes cron run ` does NOT execute the job in your terminal. It schedules the job
139+ for the gateway's next scheduler tick (within 60 seconds). The gateway runs the job
140+ in its own thread, and with ` --deliver local ` , the output is saved to a file.
141+
142+ ** Check your gateway terminal** -- you should see execution status in the gateway logs.
143+
144+ ** Read the output file:**
145+
146+ ``` bash
147+ # Wait ~60 seconds for the gateway scheduler to pick up the job, then:
148+ ls ~ /.hermes/cron/output/
149+ # You should see a directory named with your job ID
142150
151+ # Read the output (replace with your job ID)
152+ cat ~ /.hermes/cron/output/< job-id> /* .md
143153```
144- [Cron] Firing job: daily-k8s-check
145154
146- Kubernetes Health Check -- kind-lab
155+ Expected output shape (from a healthy KIND cluster):
156+
157+ ``` markdown
158+ # Kubernetes Health Check -- kind-lab
159+
147160Namespaces scanned: kube-system, default, local-path-storage
148161
149162All pods running. No restarts detected above threshold.
150163Node kind-control-plane: Ready, allocatable CPU 4 cores, memory 8Gi.
151-
152- [SILENT] (no anomalies to report)
153164```
154165
155- :::info About [ SILENT]
156- When the cron agent finds nothing to report, it responds with ` [SILENT] ` .
157- This suppresses delivery -- you will not receive a Slack or Telegram notification. This is by
158- design: agents that cry wolf on every run lose their usefulness. The agent only delivers a
159- full report when it finds something worth reporting.
166+ :::info About [ SILENT] and delivery
167+ When the cron agent finds nothing to report, it may respond with ` [SILENT] ` .
168+ This suppresses delivery to external channels -- you will not receive a Slack or Telegram
169+ notification. This is by design: agents that cry wolf on every run lose their usefulness.
170+ The agent only delivers a full report when it finds something worth reporting.
171+
172+ With ` --deliver local ` , output is always saved to ` ~/.hermes/cron/output/<job-id>/ ` regardless
173+ of whether the agent reports findings or stays silent. Check the file to see what happened.
160174:::
161175
162176### Lifecycle demo: pause and resume
0 commit comments