Cron

Cron

Use the cron tool to schedule one-time reminders or recurring tasks.

Actions

• add — schedule a new one-time or recurring job
• list — show all pending jobs
• cancel — remove a job by name

Examples

One-time Reminders

Set a one-time reminder:

cron(action="add", name="break-reminder", message="Time to take a break!", delay="20m")

Longer delay:

cron(action="add", name="standup", message="Daily standup in 5 minutes", delay="1h")

Recurring Tasks

Important: Recurring jobs have a minimum interval of 2 minutes to prevent abuse.

Daily morning reminder (every 24 hours):

cron(action="add", name="morning-standup", message="Good morning! Time for standup", delay="1h", recurring=true, interval="24h")

Every hour check:

cron(action="add", name="hourly-reminder", message="Hourly check-in", delay="1h", recurring=true, interval="1h")

Every 30 minutes:

cron(action="add", name="water-reminder", message="Drink water!", delay="30m", recurring=true, interval="30m")

Manage Jobs

List all pending jobs:

cron(action="list")

Cancel a job:

cron(action="cancel", name="break-reminder")

Parameters

Duration Format

Use Go duration strings:

Notes

• One-time jobs are removed after firing
• Recurring jobs continue until cancelled
• Minimum recurring interval: 2 minutes
• Jobs persist only while the gateway is running (not saved to disk)