Merlin Docs
Cron
Local scheduled prompts with run history and optional chat delivery.
Cron turns repeated work into durable local jobs. A job stores its prompt, schedule, state, origin, delivery policy, and run records.
Schedule Shape
| Schedule | Meaning |
|---|---|
now |
Run once immediately. |
at:2026-05-20T15:00:00Z |
Run once at a timestamp. |
every:1h |
Run on an interval. |
interval:1h |
Alias for interval schedules accepted by the store. |
weekdays:21:00 America/Toronto |
Run on weekdays at local or named timezone time. |
Delivery
| Mode | Behavior |
|---|---|
history_only |
Record the run, do not send to chat. |
origin |
Deliver to the channel where the job was created. |
explicit |
Deliver to a stored target channel. |
CLI-created jobs default to history_only. --deliver none keeps that behavior. --deliver <channel>:<chat-id> stores an explicit destination. origin is used when a channel gateway creates the job.
Commands
claw cron add --every 1h "summarize this repo"
claw cron add --at 2026-05-20T15:00:00Z --name release-check "check blockers"
claw cron add --weekdays 21:00 --tz America/Toronto "end of day"
claw cron add --schedule "weekdays:09:00 America/Toronto" --deliver web:web "morning check"
claw cron list
claw cron tick
claw cron run <job-id>
claw cron pause <job-id>
claw cron resume <job-id>
claw cron remove <job-id>