8bit64k
cronalytics
Hermes Agent plugin for cron analytics and observability — track costs, health, and trends of scheduled agentic automations.
Repository last updated Jun 24, 2026
Overview
Cronalytics is a plugin for Hermes Agent that brings observability and cost attribution to scheduled cron jobs. It hooks into the on_session_end lifecycle event to capture usage data for every cron-originated run, storing derived analytics in a local SQLite fact database. This enables developers to monitor job health, track estimated costs, and identify failure patterns across their agentic automations.
The plugin surfaces data through three complementary interfaces: a visual dashboard tab within Hermes, a command-line tool for programmatic access and scripting, and a built-in agent skill that performs automated diagnostics with confidence-graded anomaly detection. Together, these tools help teams optimize both the reliability and economics of their scheduled agent workflows.
Cronalytics is designed for developers and operators running Hermes Agent in production, especially those managing multiple cron jobs who need visibility into run outcomes, token usage, and cost trends. It supports multi-locale dashboards (English, Spanish, Chinese Simplified, Chinese Traditional) and provides both summary-level and per-job drill-down capabilities.
Highlights
- Tracks session-level usage and estimated cost for cron-originated runs
- Visual dashboard tab with charts, filters, and multi-locale support
- CLI tool with eight commands and JSON output for scripting
- Agent skill for automated health diagnostics and anomaly detection
- Backfill historical data on demand or via reconciliation scanner
Features
Dashboard
Visual exploration via a dedicated /cronalytics tab with summary cards, leader boards, cost-by-model breakdowns, per-job tables, outcome and mode filters, and day selectors (7D/30D/90D/custom).
CLI Tool
Terminal-based access with commands for summary, jobs, models, trends, health, runs, and sync. Supports --json output, outcome and mode filters, and day range selection.
Agent Skill
A built-in diagnostic skill that follows a structured 7-step workflow to analyze cron jobs, detect anomalies with confidence grades (HIGH/MEDIUM/LOW), and provide ranked recommendations.
Multi-Locale Support
Self-hosted internationalization layer localizing all UI elements and metrics for English, Spanish, Chinese Simplified, and Chinese Traditional.
Historical Backfill
Automatically backfills historical cron session data on plugin load and supports on-demand sync via dashboard button or CLI sync command.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
usage: cronalytics [-h] [--db DB] [--days DAYS] [--outcome {all,success,failure}]
[--mode {all,agent,no_agent}] [--json]
{summary,jobs,models,trends,health,runs,all,sync} ...
Cronalytics CLI — dump cron run insights to the terminal
positional arguments:
{summary,jobs,models,trends,health,runs,all,sync}
summary Aggregate headline summary
jobs Per-job breakdown with pace
models Per-model estimated cost breakdown
trends Daily run-count / estimated cost sparkline
health Fact DB health check
runs Individual runs for a job
all Run health + summary + jobs + models + trends
sync Backfill cron sessions from state.db into fact DB
options:
-h, --help show this help message and exit
--db DB Path to fact DB (default: auto-detected from plugin directory)
--days DAYS Number of days to look back (default: 30, 0 = all time)
--outcome {all,success,failure}
Filter by outcome (default: all)
--mode {all,agent,no_agent}
Filter by job mode (default: all)
--json Output raw JSON instead of formatted tablesRequirements
- Hermes Agent installed and configured
- Python 3.8+
- Hermes cron jobs running in the default profile
How it's built
Cronalytics is written in Python and integrates with Hermes Agent via the on_session_end hook. It enqueues session IDs, queries the Hermes state.db, and stores derived analytics in a plugin-owned SQLite database (facts.db). The dashboard is built as a React single-page application served from the dashboard/dist/ directory, communicating with the backend through REST API endpoints mounted at /api/plugins/cronalytics/.
The repository is organized into a cronalytics/ package containing the CLI, config, facts, ingester, scanner, and schedule modules. The dashboard source lives under dashboard/src/ with components, hooks, i18n, and lib utilities. The agent skill is implemented as a diagnostic workflow that pipes CLI output through heuristic analysis.
Data is append-only in the fact database; the scanner reconciles against state.db to backfill missing entries. All cost figures are estimated based on Hermes's internal calculations and should be used for directional awareness, not accounting.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The 8bit64k/cronalytics repository is the authoritative source and the place to file issues or contribute.
Category: Observability & Telemetry · Licensed under MIT