Schedules

A schedule repeats work at configured times while a scheduler process is available.

To run a workflow.rattish on a schedule, add a trigger.

Rattish compatibility boundary

The Raticode schedule commands load the legacy workflow configuration. Raticode schedule add doesn't accept workflow.rattish. Use Raticode rattish triggers add cron instead.

Schedule a Rattish command externally

An OS scheduler or CI system can also run a workflow directly, which suits machines where Raticode's scheduler won't be running:

Raticode rattish run /absolute/project/.raticode/WORKFLOW_ID/workflow.rattish --format json

Use an absolute executable path if the scheduled environment does not inherit your interactive PATH. Configure the same project resources, provider authentication, environment variables, and secrets on the executing machine. Test check and preflight under that environment before enabling the job.

An external schedule executes real work. Choose overlap behavior deliberately so a slow run does not collide with the next occurrence. Keep the process output and exit status for diagnosis.

Existing built-in schedules

For a workflow already using the compatible legacy scheduler, Raticode schedule list shows registered jobs. Raticode schedule start --foreground runs the scheduler in the current process; Raticode schedule start starts its background mode. Raticode schedule stop stops that background scheduler. Raticode schedule remove WORKFLOW_ID removes a registration.

The scheduler uses APScheduler and a persisted SQLite job store. Jobs remain registered when the scheduler stops, but they cannot execute while their scheduler process is unavailable. Do not interpret a saved job as an installed operating-system service.

Check the environment

Scheduling problems often come from a different working directory, missing PATH entries, a sleeping computer, or a provider login unavailable in the background environment. Saving a schedule does not install dependencies or wake a computer.

Use CLI reference and Validation and preflight. Organization routines are a separate experimental feature described in Organizations.