cron

Local-first recurring schedule engine for reminders, repeated tasks, and time-based execution plans. Use whenever the user mentions recurring timing, repetition, schedules, cadence, weekly/daily/month

SKILL.md

GitHub

Cleanup Review

python scripts/_purge_cache.py is an optional cleanup helper for the Cron skill. It may recursively remove ~/.cache/skill_tmp, ~/.skill_state. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

Cron

Turn recurring intentions into structured local schedules.

Core Philosophy

  1. Repetition should be captured once, then trusted.
  2. A schedule is not just a reminder — it is an execution contract over time.
  3. The system should make recurrence visible, editable, and pausable.
  4. Users should always know what runs next.

Runtime Requirements

  • Python 3 must be available as python3
  • No external packages required

Storage

All data is stored locally only under:

  • ~/.openclaw/workspace/memory/cron/jobs.json
  • ~/.openclaw/workspace/memory/cron/runs.json
  • ~/.openclaw/workspace/memory/cron/stats.json

No external sync. No cloud storage. No third-party cron service.

Job Status

  • active: schedule is live
  • paused: temporarily disabled
  • archived: no longer active, kept for history

Schedule Types

  • daily
  • weekly
  • monthly
  • interval

Key Workflows

  • Capture recurring job: add_job.py
  • See what runs next: next_run.py
  • Pause or resume: pause_job.py, resume_job.py
  • Inspect one job: show_job.py
  • Review all jobs: list_jobs.py