cronjob

name	CronJob
description	Manage cron jobs with execution logging and failure alert tracking. Use when adding tasks, monitoring execution, debugging failed crons.
version	2.0.0
author	BytesAgain
homepage	https://bytesagain.com
source	https://github.com/bytesagain/ai-skills
tags	["cron","job","scheduler","automation","admin","linux"]
categories	["Developer Tools","Utility"]

CronJob

A thorough sysops toolkit for scanning, monitoring, reporting, and maintaining scheduled job operations. CronJob provides 18+ commands for tracking job events, performing health checks, managing backups, benchmarking performance, and exporting operational data in multiple formats.

Commands

Command	Description
cronjob scan <input>	Record a scan entry — run without args to view recent scan entries
cronjob monitor <input>	Record a monitoring observation — run without args to view recent entries
cronjob report <input>	Log a report entry — run without args to view recent reports
cronjob alert <input>	Record an alert — run without args to view recent alerts
cronjob top <input>	Log a top-level event — run without args to view recent entries
cronjob usage <input>	Track usage data — run without args to view recent usage entries
cronjob check <input>	Record a check result — run without args to view recent checks
cronjob fix <input>	Log a fix action — run without args to view recent fixes
cronjob cleanup <input>	Record a cleanup operation — run without args to view recent cleanups
cronjob backup <input>	Log a backup event — run without args to view recent backups
cronjob restore <input>	Record a restore operation — run without args to view recent restores
cronjob log <input>	Add a general log entry — run without args to view recent log entries
cronjob benchmark <input>	Record a benchmark result — run without args to view recent benchmarks
cronjob compare <input>	Log a comparison — run without args to view recent comparisons
cronjob stats	Display summary statistics across all log categories
cronjob export <fmt>	Export all data to a file (formats: json, csv, txt)
cronjob search <term>	Search across all log files for a keyword
cronjob recent

Each data command (scan, monitor, report, etc.) works in two modes:

• With arguments: Records the input with a timestamp into its dedicated log file
• Without arguments: Displays the 20 most recent entries from that category

Data Storage

All data is stored locally in plain-text log files:

• Location: ~/.local/share/cronjob/
• Format: Each entry is saved as YYYY-MM-DD HH:MM|<value> in per-category .log files
• History: All operations are additionally logged to history.log with timestamps
• Export: The export command can generate JSON, CSV, or TXT files from all log data
• No cloud sync — everything stays on your machine

Requirements

• Bash 4.0+ (uses set -euo pipefail)
• Standard Unix utilities: date, wc, du, head, tail, grep, basename, cat
• No external dependencies, no API keys, no network access required
• Works on Linux and macOS

When to Use

1. Cron job monitoring — Track the execution status of scheduled jobs, log failures, and set up alerts for review
2. Job audit trail — Record scan, check, and report entries to maintain a complete history of job operations
3. Backup & restore logging — Log backup and restore events with timestamps so you always know what happened and when
4. Performance benchmarking — Record benchmark results for scheduled tasks and compare them over time to spot regressions
5. Operational data export — Export all collected logs in JSON, CSV, or TXT format for dashboards, compliance, or further analysis

Examples

# Record a scan of cron job health
cronjob scan "all 12 scheduled jobs ran successfully today"

# Log a monitoring observation
cronjob monitor "backup-job took 45min, 3x longer than usual"

# Record an alert for a failed job
cronjob alert "daily-report cron failed at 03:00 — exit code 1"

# Log a fix action taken
cronjob fix "increased timeout for backup-job from 30m to 90m"

# View summary statistics across all categories
cronjob stats

# Export all data to CSV for spreadsheet analysis
cronjob export csv

# Search for entries related to a specific job
cronjob search "backup-job"

# Quick health check
cronjob status

# View the 20 most recent activity entries
cronjob recent

Configuration

Set CRONJOB_DIR to change the data directory. Default: ~/.local/share/cronjob/

---

Powered by BytesAgain | bytesagain.com | [e-mail]