crony

Crony Skill

Manage cron jobs with natural language scheduling and inspect computed upcoming run times.

Installation Check

crony --help

If not installed:

uv tool install "git+https://github.com/lirrensi/agent-sommelier"

Usage

Add a Job

crony add <name> <schedule> <command>
crony add <name> "<cron_expr>" <command> --cron

The --cron flag treats the schedule as a raw 5-field cron expression instead of natural language:

crony add myjob "*/5 * * * *" "python script.py" --cron
crony add nightly "0 2 * * *" "backup.sh" --cron

Working directory preservation: When a job is added, crony automatically captures the current working directory. When the OS scheduler runs the job, it cds to that directory first, so relative paths in commands work correctly regardless of where the scheduler executes. You can still manually add cd anyway: cd /path/to && command.py

List Jobs

crony list
crony list --sync
crony list --json

crony list shows a Next Run column for one-off and recurring jobs. crony list --json includes a computed next_run field for each job.

Remove Job

crony rm <name>

Run Job Now

crony run <name>

View Logs

crony logs <name>

Schedule Formats

One-off Jobs

crony add backup "in 5m" "python --version"
crony add report "at 15:30" "python send_report.py"
crony add deploy "on 2026-03-10" "python deploy.py"

Recurring Jobs

crony add ping "every 1h" "python --version"
crony add cleanup "every 24h" "python cleanup.py"
crony add weekly "every monday" "python weekly_report.py"
crony add weekday "every weekday" "python daily_check.py"

# Raw cron expression (bypasses natural language parser)
crony add nightly "0 2 * * *" "backup.sh" --cron
crony add every-5min "*/5 * * * *" "python check.py" --cron

Interval Syntax

• in 5m, in 1h, in 2d - Relative one-off
• at 15:30, at "2026-03-10 10:00" - Absolute one-off
• every 1h, every 30m, every 24h - Interval recurring
• every monday, every weekday, every weekend - Day-based recurring

Examples

# Health check every hour
crony add health "every 1h" "python --version"

# Daily backup
crony add backup "every 24h" "python backup.py"

# Weekly report
crony add report "every friday" "python generate_report.py"

# One-time reminder
crony add remind "in 30m" "python --version"

# Inspect upcoming run times
crony list
crony list --json

Platform Support

Jobs are registered with the native OS scheduler:

• Linux/macOS: Uses crontab — wraps command with cd /path && cmd via shlex.quote()
• Windows: Uses Task Scheduler — writes a .bat wrapper in ~/.crony/scripts/ with cd /d "CWD"

The working directory is captured at add time and stored in the cwd field of ~/.crony/jobs.json so relative paths in commands work reliably.

Job metadata is stored in ~/.crony/jobs.json for easy management.