zeroclaw cron

Configure and manage scheduled tasks

The zeroclaw cron command manages scheduled tasks using cron expressions, timestamps, or intervals.

Overview

Schedule recurring or one-time agent tasks:

• Cron expressions (5-field format)
• RFC 3339 timestamps
• Duration-based delays
• Fixed intervals

Subcommands

list

List all scheduled tasks.

zeroclaw cron list

Output:

ID       Schedule            Next Run              Message
ab12cd   0 9 * * 1-5         2026-03-04 09:00 EST  Good morning
ef34gh   */30 * * * *        2026-03-03 12:30 UTC  Check system health
ij56kl   2026-03-15 14:00Z   2026-03-15 14:00 UTC  Send reminder

add

Add recurring task with cron expression.

zeroclaw cron add '<expression>' '<message>' [--tz <timezone>]

Parameters:

expression · string · required

Cron expression (5 fields): min hour day month weekday

message · string · required

Message to send to agent when task runs

--tz · string · default: "UTC"

IANA timezone name (e.g., America/New_York)

Examples:

# Every weekday at 9 AM EST
zeroclaw cron add '0 9 * * 1-5' 'Good morning' --tz America/New_York

# Every 30 minutes
zeroclaw cron add '*/30 * * * *' 'Check system health'

# First day of month at midnight
zeroclaw cron add '0 0 1 * *' 'Monthly report'

add-at

Schedule one-time task at specific time.

zeroclaw cron add-at '<timestamp>' '<message>'

Parameters:

timestamp · string · required

RFC 3339 timestamp (e.g., 2026-03-15T14:00:00Z)

Examples:

zeroclaw cron add-at '2026-03-15T14:00:00Z' 'Send reminder'
zeroclaw cron add-at '2026-12-25T00:00:00-05:00' 'Merry Christmas!'

add-every

Repeat task at fixed interval.

zeroclaw cron add-every <milliseconds> '<message>'

Examples:

# Every 60 seconds
zeroclaw cron add-every 60000 'Ping heartbeat'

# Every 5 minutes
zeroclaw cron add-every 300000 'Status check'

once

Run task once after delay.

zeroclaw cron once <duration> '<message>'

Duration format: <number><unit> where unit is s, m, h, or d

Examples:

zeroclaw cron once 30m 'Run backup in 30 minutes'
zeroclaw cron once 1h 'Check deployment status'
zeroclaw cron once 1d 'Daily summary'

remove

Remove scheduled task.

zeroclaw cron remove <task-id>

pause

Pause task without deleting.

zeroclaw cron pause <task-id>

resume

Resume paused task.

zeroclaw cron resume <task-id>

Cron Expression Format

Five fields: min hour day month weekday

min · string

Minutes (0-59)

hour · string

Hours (0-23)

day · string

Day of month (1-31)

month · string

Month (1-12)

weekday · string

Day of week (0-7, where 0 and 7 = Sunday)

Special Characters

• * - Any value
• , - Value list (e.g., 1,15 = 1st and 15th)
• - - Range (e.g., 1-5 = Monday through Friday)
• / - Step (e.g., */15 = every 15 minutes)

Examples

# Every hour
'0 * * * *'

# Every day at midnight
'0 0 * * *'

# Weekdays at 9 AM
'0 9 * * 1-5'

# Every 15 minutes
'*/15 * * * *'

# First Monday of month at 8 AM
'0 8 1-7 * 1'

Task Storage

Tasks are stored in ~/.zeroclaw/cron.db (SQLite).

Backup tasks:

cp ~/.zeroclaw/cron.db ~/.zeroclaw/cron.db.backup

Related

• Daemon Command
• Running Agents