cron-troubleshooting

Diagnose and fix Hermes Agent cron job failures including missed runs, delivery errors, and provider drift.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/timchap/dot-hermes --skill cron-troubleshooting-timchap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cron-troubleshooting
Source: https://github.com/timchap/dot-hermes/tree/main/skills/cron-troubleshooting
Command: npx skills add https://github.com/timchap/dot-hermes --skill cron-troubleshooting-timchap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Cron jobs in Hermes Agent silently fail for non-obvious reasons: the gateway process was not running, output was routed to an undeliverable WebUI session, or the global model/provider config drifted after the job was created. This Skill provides systematic diagnostic flows to identify the root cause and apply the correct fix. ## Core Features & Use Cases - Missed Run Diagnosis: Trace why overnight cron jobs never fired by checking the gateway process, agent logs, and the conversation-loop-dependent scheduler model. - Delivery Failure Resolution: Fix jobs that ran successfully but never reached the user, including the WebUI "unknown platform" mismatch and CLI/TUI deliver='local' pitfalls. - Provider/Model Drift Repair: Pin provider and model on unpinned jobs by directly editing ~/.hermes/cron/jobs.json when the CLI lacks edit flags. - Use Case: A user wakes up to find their nightly summary cron job never arrived. Use this Skill to check cronjob action='list', inspect last_delivery_error, discover the job targeted the WebUI, and update it to deliver='all' so results reach Discord or Telegram. ## Quick Start Diagnose why my scheduled cron job did not deliver its output last night and fix the delivery target.

Frequently Asked Questions about cron-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why did my cron job not run overnight?▼

Cron jobs in Hermes fire from a tick thread inside the gateway process, not the agent conversation process. If the gateway was not running overnight, jobs are skipped. Install the gateway as a systemd service with `sudo hermes gateway install --system` for reliable execution.

How do I fix a cron job that ran but never delivered output?▼

Check `cronjob action='list'` for `last_delivery_error`. If it mentions "unknown platform 'webui'", the job used `deliver: origin` while the active session was the WebUI, which has no delivery channel. Update the job with `deliver='all'` or a specific platform like Discord.

How do I change the provider or model on an existing cron job?▼

The `hermes cron edit` CLI has no provider or model flags, so edit `~/.hermes/cron/jobs.json` directly. Set the `provider` and `model` fields on the job entry, then verify with `cronjob action='list'`.

What causes the global inference config drift error on cron jobs?▼

The drift error fires when a job was created without pinned provider/model values and the user's default config later changed. Hermes blocks execution to prevent unintended spend. Fix it by pinning provider and model directly in jobs.json.

Why do reminders created from the CLI never reach me?▼

CLI and TUI sessions default to `deliver='local'`, which saves output to disk only with no live delivery channel. Create reminder jobs with `deliver='origin'` or `deliver='all'` so output routes through connected gateways like Discord or Telegram.