Schedule tasks

Last published : Nov 09, 2026
This guide shows you how to run a prompt on a schedule, check its runs, and pause, change, or delete it.
A scheduled task sends the same prompt at the times you choose, without you there. Because no one is there to answer, a run doesn't stop to ask you questions: the assistant decides, and says what it assumed. Each run opens as its own chat that you can review and continue. All runs of a task share one folder, so each run can build on the last.

Create a scheduled task

  1. In the sidebar, next to Scheduled tasks, select New scheduled task (+).
  2. Optional: enter a Name, for example Nightly dependency check.
  3. Under Prompt, enter what the assistant should do each time.
  4. Under First run, choose the date and time.
  5. Under Repeat, choose one of the following:
    • Once
    • Every day
    • Weekdays (Mon–Fri)
    • Every week
  6. Under Model, choose Default or Thinking.
  7. Under Workspace, choose where the runs read and write files:
    • Own folder (auto-created): a folder just for this task, under ~/Knowledge_Worker_Agent/Scheduled Tasks.
    • Run this task as part of a project: the runs share a project's folder. Choose the project.
  8. Select Create task.
You can't change a task's workspace after you create it.

Know when a task runs

Times use your workspace's local time. A task runs only while your workspace is running.
If your workspace was off at a scheduled time, one catch-up run starts when the workspace starts again, for the latest time it missed. If that time is more than two hours ago, the task asks you first. It says that a scheduled run was missed while the workspace was off, and when. Select Run now or Skip.
In the sidebar, a task that needs this decision is marked Needs attention.

See a task's runs

  1. In the sidebar, under Scheduled tasks, select View all.
    The Scheduled tasks page lists your tasks with their next run and how many times they ran.
  2. On a task, select Run history.
  3. Select a run to open its chat.
Each run shows its status: Running, Succeeded, or Failed. It also shows what started it: Scheduled, Catch-up, or Manual. A run you haven't opened yet is marked New.

Run a task now

On the task, select Run now. The run is marked Manual.

Pause or resume a task

On the task, select the switch (Pause or Resume). A paused task shows Paused and doesn't run until you resume it.

Change a task

  1. On the task, select Edit.
  2. Change what you need.
  3. Select Save changes.

Delete a task

  1. On the task, select Delete.
  2. Confirm.
The task and its run history are removed. The task's folder stays on disk.