Cronalytics is a plugin for Nous Research's Hermes Agent that attributes usage and estimated cost to every cron-originated run, so you can see what your scheduled jobs cost. It hooks into the onsessionend event, queries the Hermes state.db, and stores derived analytics in a plugin-owned, append-only SQLite fact database (facts.db). Historical runs are backfilled on plugin load or on demand through a Sync Now action.
Three interfaces read from that database. A /cronalytics tab inside hermes dashboard shows summary cards, a leader board, cost-by-model bars, a sortable per-job table with expandable token and schedule detail, a run-history modal, and explainer modals for pace, nominal, trend, and the cost math, with filters for outcome, job mode, and time window; the UI is localized in English, Spanish, Simplified Chinese, and Traditional Chinese. A cronalytics CLI exposes summary, jobs, runs, models, trends, health, all, and sync subcommands with --days, --outcome, and --mode filters and --json output. An agent skill guides Hermes through a seven-step diagnostic workflow (time window, baseline, job-level drill, per-run investigation, failure pattern, model economics, trend validation) and grades each finding HIGH, MEDIUM, or LOW confidence with supporting evidence.
Cost figures are the estimates Hermes stores in state.db rather than invoice values. The success signal reflects whether the cron wrapper exited cleanly, not whether the agent's output achieved its goal. The plugin observes the Hermes profile it is installed in; jobs created under a non-default profile run in a separate gateway and are not visible.
Features
- Session capture: the onsessionend hook records cost, token counts, model, duration, and success state per cron run
- Backfill: reconciliation scanner imports historical cron sessions from state.db
- Dashboard tab: summary cards, leader board, per-model and per-job breakdowns, run history, and explainer modals
- Filters: outcome (all/success/failure), mode (agent/no agent), and 7D/30D/90D or custom day ranges
- CLI: eight subcommands with global filters, JSON output, and job-name resolution from ~/.hermes/cron/jobs.json
- Agent skill: structured diagnostic workflow with confidence-graded anomaly detection and guardrails against false positives
- HTTP API: /api/plugins/cronalytics/ endpoints for health, summary, jobs, runs, models, trends, and sync
- Localization: English, Spanish, Simplified Chinese, and Traditional Chinese
