# 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/monthly routines, future triggers, or wants to know what runs next. Captures natural language timing into structured local schedules, supports pause/resume, and surfaces upcoming executions. No external sync.

- Skill: `knownasnaffy/cron-8` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/cron-8`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/cron-8/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/cron-8

---




### Helper Behavior Review

`python scripts/_run.py` is an optional helper whose behavior should be compared with this skill's documented purpose before use. Show what the script does, explain any mismatch with the user-facing description, and run it only when the user explicitly wants that diagnostic path.

# 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`