Synopsis
Description
cron manages scheduled tasks that run automatically on a schedule. Cron jobs can trigger agent tasks, send notifications, sync data, or run any configured workflow. They use standard cron expression syntax for scheduling and are defined in config/cron.yml or via the API.
Subcommands
| Subcommand | Description |
|---|---|
list | List all configured cron jobs |
show <id> | Show details for a cron job |
trigger <id> | Manually trigger a cron job immediately |
enable <id> | Enable a disabled cron job |
disable <id> | Disable a cron job without deleting it |
create | Create a new cron job (interactive or with flags) |
delete <id> | Delete a cron job |
cron list
Show only enabled cron jobs.
Output as JSON array.
cron trigger <id>
Executes the cron job immediately regardless of its schedule. Useful for testing before deployment or running jobs on demand.
Output trigger result as JSON.
cron create
Job name (unique identifier).
Cron schedule expression (e.g.,
0 9 * * 1-5 for weekdays at 9am).Agent prompt to execute on schedule.
Agent to assign the scheduled task to.
Examples
Cron Expression Reference
| Expression | Description |
|---|---|
0 9 * * 1-5 | Weekdays at 9:00 AM |
0 */2 * * * | Every 2 hours |
0 0 * * * | Daily at midnight |
0 0 * * 0 | Weekly on Sunday |
0 0 1 * * | Monthly on the 1st |
*/15 * * * * | Every 15 minutes |
Related
profclaw task- Tasks created by cron jobs appear hereprofclaw serve --no-cron- Disable cron when starting the server- Cron Templates - Pre-built schedule configurations