Schedule tasks
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
-
In the sidebar, next to Scheduled tasks, select New scheduled task (+).
-
Optional: enter a Name, for example Nightly dependency check.
-
Under Prompt, enter what the assistant should do each time.
-
Under First run, choose the date and time.
-
Under Repeat, choose one of the following:
-
Once
-
Every day
-
Weekdays (Mon–Fri)
-
Every week
-
-
Under Model, choose Default or Thinking.
-
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.
-
-
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
-
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.
-
On a task, select Run history.
-
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
-
On the task, select Edit.
-
Change what you need.
-
Select Save changes.
Delete a task
-
On the task, select Delete.
-
Confirm.
The task and its run history are removed. The task's folder stays on disk.