Skip to main content
Triggers define when a job runs. Four types are supported.

Cron

Recurring schedule using cron expressions:
Standard 5-field cron format: minute hour day-of-month month day-of-week. Catch-up: If the daemon was suspended (e.g., laptop sleep) and a cron window was missed, the job fires once on resume. Only one catch-up run per job — no queue of missed executions.

Interval

Repeating at a fixed interval:
The interval starts from when the daemon starts, not from a specific time.

One-Shot

Fire once at a specific datetime, then disable:
After firing, the job’s _state.last_status is updated and it won’t run again.

Webhook

Fire when the daemon receives an HTTP POST:
The daemon exposes webhook endpoints:

Payload Templating

Use {{field}} in the job prompt to inject webhook payload values:
Nested fields are supported: {{pull_request.base.ref}}.