Skip to main content

Routines & saved prompts

The Desktop offers two ways to avoid repeating work: Routines, which run a task on a schedule, and Saved Prompts, reusable instructions you trigger manually. They look similar but serve different purposes — this page makes the distinction clear.

The difference in a table​

RoutinesSaved Prompts
ScopeGlobal to your userPer project
TriggerScheduled (automatic)Manual only (Run Now)
Where it livesRoutines drawerWorkspace → Saved Prompts
Notifies on completionYes (configurable)No
History + artifactsYes—
Desktop only

Routines and Saved Prompts are Desktop features. Routines run while the app is open — the scheduler lives in the app, not on a server.

Routines​

A routine runs a prompt at a set time or interval — for example, "every Monday at 8 a.m., generate the weekly report." Routines are global to your user: they don't belong to a specific project.

Create a routine​

  1. Open the Routines drawer and click + New routine.
  2. Fill in the fields:
FieldWhat it's for
TitleName of the routine
PromptThe instruction the agent will run
Schedule kindonce, daily, weekly, monthly, interval, or weekdays
At (HH:MM)Trigger time (for time-based schedules)
Weekday / DayDay of the week (weekly) or of the month (monthly)
IntervalISO-8601 period for interval (e.g., PT2H = every 2 hours)
TimezoneTime zone used to compute the times
Run modelocal_plain or local_protected (see Execution modes)
EnabledTurns the routine on/off
Retries / Max runtime / Artifact retainAttempts, maximum time, and artifact retention
Notify oncomplete, failure, ask_user
  1. Save. From then on, the routine fires according to the schedule — as long as the Desktop is open.

Manage and follow​

  • Run now runs the routine immediately, outside the schedule.
  • Pause suspends the triggers without deleting the routine; Delete removes it.
  • Each routine keeps a history of runs and the artifacts produced, accessible right in the drawer.

Notifications​

Set Notify on to be alerted when a routine completes or fails. The alerts arrive through the Desktop notification center (native toast + in-app fallback). See Notifications.

The app must be open

Because the scheduler runs inside the Desktop, a routine does not fire while the app is closed. For tasks that should run without you around, leave the app open during the scheduled window.

Saved Prompts​

A saved prompt is a reusable instruction within a project. Unlike routines, it's manual only: there's no scheduling by design — you trigger it with Run Now whenever you want.

Use saved prompts for instructions you repeat often in a project, but at moments only you decide — for example, "review the changelog and propose the release note" before each release.

They live in Workspace → Saved Prompts (shortcut Alt+5 on the Desktop) and belong to the current project, not to your user globally.

Which to use​

  • Needs to run on its own, at a fixed time → Routine.
  • An instruction you repeat, but trigger by hand, tied to a project → Saved Prompt.

For a complete walkthrough of automating a weekly report, see the dedicated recipe.

See also​