cronlag

Configuration

CLI flags

FlagDefaultMeaning
-d, --days7window to inspect (1–90)
-w, --workflowallonly this workflow: file name (nightly.yml or nightly), path, display name or id; repeatable
-f, --formattexttext, json, markdown
--orgorg-wide scan (same as cronlag org <org>)
--fail-onneverdropped: exit 1 on DROPPING / NOT FIRING / DISABLED / INVALID; late: also LATE
--late1hlag above which a run is "very late" (also the LATE verdict threshold for the median)
--on-time10mlag still counted as on time
--liteoffskip the workflow-file history lookup (fewer API calls; cron changes in the window are then not detected)
--grace15mcatchup: how long after a slot before it counts as missed
--dispatchoffcatchup: actually dispatch
--tz, -nUTC, 5explain: timezone and number of fire times
--tokenenv / ghGitHub token
--no-colorautoplain output (NO_COLOR and FORCE_COLOR are honored)

Durations accept s, m, h, d (90m, 2h).

Action inputs

InputDefault
modereportreport or guard
repothis repoowner/repo
days7report window
workflowcomma-separated file names
fail-onneveras the CLI flag
tokengithub.tokenneeds actions:read

Fixed rules