Skip to content
SupaCloud Docs
Select themeSelect language

Set up a schedule

A schedule is a persisted task template. When the scheduled time arrives the server creates a regular task from the stored project, agent, and prompt — with the same budget checks, workspace scoping, and agent lifecycle as a manually started task.

Four cadences are available: once (a single future run), daily, weekly, and monthly.

The schedules view listing scheduled tasks with their cadence and next-run time.The schedules view listing scheduled tasks with their cadence and next-run time.

Create a schedule

Section titled “Create a schedule”
  1. Open Tasks in the sidebar and click Start task.
  2. The dialog leads with the prompt — write what the agent should do, then pick the project and agent just below it. Any secondary field (title, profile, model, effort, Git workflow, issue link) lives under the More options disclosure; you can leave it collapsed for a quick run.
  3. In the When segment, choose Schedule (instead of Now). This reveals the cadence controls in place — no separate toggle.
  4. Pick the cadence (once, daily, weekly, or monthly) and set the time or date/time.
  5. Click Create schedule — the task does not launch immediately; it is queued for the next due time.

To review all schedules in the workspace, open Build → Schedules.

Pause and resume a schedule

Section titled “Pause and resume a schedule”

A paused schedule is retained but skipped by the background worker until it is resumed.

schedule pause <id>
schedule resume <id>

Short schedule IDs are resolved the same way as task IDs in the terminal.

Delete a schedule

Section titled “Delete a schedule”
schedule delete <id>

Deleting is permanent. Pause first if you may want to reactivate later.

See also

Section titled “See also”