Desktop

Automations

Schedule work for the agent to run on its own.

An automation runs a task on a schedule: a nightly dependency check, a weekly report, a recurring cleanup. Find them under Automations in the sidebar.

Create an automation

Choose New automation, or type /automation in a session to turn the current task into one.

FieldWhat it sets
ScheduleEvery an interval, Run at a time, or a Cron expression, in your Timezone.
ModeHow the run works.
Where it runsAuto, Local (your project folder) or Worktree (its own branch).
Target threadContinue an existing session, or start a new one each run.
Stop whenThe condition that ends a run.
Max iterationsAn upper limit on steps per run.
On failureWhat to do when a run fails.
NotifyWhether to notify you when a run finishes.

Runs appear in the sidebar like sessions, so you can read what happened and continue the conversation. Control how they're shown in Settings › General › Automation runs.

On this page