Scheduled runs and history

Each time a scheduled task runs, its work happens in a new chat. This page shows where runs appear, what the history records, why a run was skipped or stopped, and when Oda notifies you. To create or change a task, see Schedule recurring tasks.

Where a run appears

How a run starts

While no one is watching

Runs are unattended, so a few things work differently from a chat you sit in:

Run statuses

A task starts one run at a time, and waiting runs start in the order they were queued. A slot that arrives while the previous run is still going is recorded as Skipped.

StatusWhat it means
QueuedThe run is waiting to start.
RunningThe run is going now.
DoneThe run finished, including a run that stopped at its output limit.
FailedThe run ended with an error; the history keeps the error's message.
SkippedThe slot did not start a run; the history names the reason.
AbortedThe run was stopped: it reached the task's time limit, or you stopped it.

Why a run was skipped or stopped

The history gives a reason for every run that did not go as planned:

Skipped slots are not caught up. When Oda comes back, a slot it reaches shortly after its time still runs, the newest missed slots are kept in the history, and nothing runs twice to catch up. Around daylight-saving changes, a local time the clock skips runs the same distance after the gap, and a time the clock repeats runs once, at its first occurrence.

For the wake setting, and how Oda wakes a sleeping computer, see Wake the computer for a scheduled run.

Notifications

Reading the run history

  1. Open the task: click it under Scheduled, or use All runs → on its runs.
  2. Find the run in the history. Each row shows the time and its trigger (Scheduled or Run by hand), the status, the actions the run was denied (1 denied, or None), the duration (1 h 05 min), the tokens used (compact counts such as 12K), and the run's chat.
  3. Choose Open to read the run's chat, or Stop to stop a run that is going or queued. A Skipped row offers Run now while the task has no active run.

A task with no runs yet shows No runs yet. New results count as unread: the task shows 2 new, and Mark all read clears the count. Opening a run marks it read. Your start page adds a line when there are new results or something needs you, for example 2 scheduled runs finished. or 1 needs you →.

Questions, answered

Where do I find the chat a run created?

Under Scheduled in the sidebar, inside its task, or in the task page's history. Opening a run opens its chat and marks the run read. Search names run chats Scheduled · <task>.

Why was my run skipped?

The history row names the reason. Common ones: the computer was asleep or Oda was closed at the slot's time, the previous run had not finished, or the task asks for Full access your account does not allow. Skipped slots are not caught up.

Are missed runs caught up later?

No. When Oda comes back, a slot it reaches shortly after its time still runs, but older missed slots stay as Skipped records, and a task never runs twice to catch up.

Why did my run stop before it finished?

Two causes: the run reached the task's time limit (the reason reads <n>-hour limit reached.), or you stopped it (Stopped by you.). To give long work more time, change the task's Time limit; see Schedule recurring tasks.

Can I stop a run myself?

Yes. A running or queued run offers Stop in its history row and in the Activity feed. The history records it as Aborted, with the reason Stopped by you.

Why did my run fail?

The history keeps the error's message. Two common messages: Sign in required. when Oda was signed out (sign in again, then the next run works), and the Full access sentence when your account does not allow it. If the message is unexpected, keep it and contact your administrator; Troubleshooting lists common messages.

Which runs send a notification?

Failed and stopped runs always notify. A run that finishes notifies only when the task has Notify when a run finishes on. Skipped runs never notify, and clicking a notification opens the run's chat.

What do the prompt variables become when a run starts?

{{now}} and {{scheduledFor}} become the run's start time and its scheduled time, in your computer's time. {{lastSuccessfulRun}} becomes the time of the last successful run, and is empty before the first successful run. Variables Oda does not know stay as written.

Why does a task say "Needs attention"?

It has a run that failed or was stopped and you have not opened it yet, or the task itself has a problem. Open the task to look; Mark all read clears unread runs.

Why is a run missing from my workspace files?

Runs and task folders are kept out of the usual workspace lists and pickers, so the lists keep only your own work. You always find runs under Scheduled, and search finds them named Scheduled · <task>. For the workspace lists themselves, see Browse workspace files.