- Scheduled task: an instruction that belongs to a project. At the set time, the Agent runs it on the cloud server in that project, and each run creates a session (or continues in the same session). You create it on the Scheduled board, or the Agent drafts it in a session and it takes effect after you confirm.
- Session timer: a timer bound to a session. At the set time, it sends a trigger message in that session, and the Agent continues working. The Agent can create it directly in a session (no confirmation needed), and you can also create one in the timer panel in the session top bar. Repeating session timers expire after 7 days and can be renewed.
Entry points
- Scheduled in the left icon bar of the desktop app, or Scheduled at the bottom of the sidebar in the web app.
- Search for Go to · Scheduled tasks in the command menu (
⇧⌘P,Ctrl+Shift+Pon Windows). - In-app notifications (scheduled task completed, failed, or paused) open that scheduled task when clicked.
- Session timers have additional entry points: the timer icon in the session top bar, or … › Session timers in the top bar.
Board
The list on the left is grouped into Upcoming, Paused, and Ended. Each row shows the next run time and the schedule. Session timers also show their session and expiry time. Click a row to open its details on the right. In the details you can:
The details also show the schedule, next run, project, model, notifications, how it was created (tasks created from a session link back to that session), the instructions, and the runs.
Runs has one row per run, showing the time and result (in progress, Done, Failed · reason, Skipped · reason, Stopped). Click a record that has a session to open the session for that run.
Create a scheduled task
- On the board, click New task to open Schedule a task. Without Plus, the subscription dialog opens first, and you return here automatically after subscribing.
- In the text box, write what to run on a schedule.
- Choose a Project: the default is your most recently used project. When you have no projects yet, you need to create and publish a project first.
- Choose Repeat, then fill in the time for that repeat option (see the table below).
- (Optional) Expand Advanced to adjust other settings.
- Click Create. It shows Scheduled · next run X.
- Time uses half-hour steps, in your local time.
- Instructions can be up to 16 KiB. Each run lasts at most 1 hour, and a run that exceeds this is recorded as Timed out.
- One-time tasks move to Ended after they run.
Advanced settings
Scheduled tasks have no permission setting: cloud scheduled tasks always run with full access.
Edit a scheduled task
In the details, click the pencil icon to open Edit scheduled task. The fields are the same as when creating. You can move the task to another of your projects. Tasks created from a session cannot change project.Drafted by the Agent in a session
In any session, ask for a schedule in natural language, for example “check for dependency updates every weekday at 9 AM”. The Agent drafts a scheduled task, and a confirmation card appears in the session. The scheduled task in the confirmation card does not run until you click Create.- Create: takes effect immediately. The card changes to Scheduled · next run X, with View in Scheduled.
- Edit: opens Edit scheduled task to make changes. After saving, click Create.
- Not now: nothing is created.
Session timers
A session timer is bound to a session: at the set time, it sends a trigger message in that session, and the Agent continues working in it. It suits tasks tied to the context of the current session, such as “check the deployment again in 30 minutes” or “look at the queue every hour”.- Created by the Agent: the Agent can create, modify, and delete timers for the current session directly, without your confirmation. Each change leaves a line in the timeline.
- Timer panel: when a session has timers, a timer icon appears next to the title in the top bar. When it has none, open the panel from … › Session timers in the top bar. In the panel, you can Run now, Turn off / Turn on, Renew, and Delete each timer.
- New timer: in the panel, click New timer, fill in Prompt and Name (optional), choose In N minutes (up to 7 days) or Repeating (cron) (a 5-field cron expression, at least 5 minutes apart), and click Create.
- Stopping a session ends only the current turn. Session timers stay active.
When a timer fires
- At the set time, a Timer fired · name message appears in the session, and the Agent starts the turn.
- When the session is busy, it follows the timer’s When busy setting: Skip this run or Wait in queue.
- One-time timers turn off automatically after firing.
Expiry and renewal
- A repeating session timer is valid for 7 days after it is created. Within 24 hours before expiry, the panel marks it Expiring soon, and the timeline shows a reminder with a Renew button. Clicking it extends the timer by 7 days.
- An expired timer is turned off. Renew it first, then turn it on.
- Renewal keeps the original on or off state: a timer you turned off yourself stays off after renewal. A timer turned off by expiry is turned on again after renewal.
Run rules
Auto-pause after repeated failures
After 3 failed runs in a row, a scheduled task is paused automatically. The board shows Paused after failures, and you receive a notification. Check the failure reason in the runs, fix it, and click Resume.Delete
Click the delete icon in the details and confirm. The schedule no longer runs, and its runs are deleted. Sessions it already created and messages in the session are kept.Notes and limitations
- The shortest fixed interval for scheduled tasks is 15 minutes. The minimum interval for repeating session timers is 5 minutes.
- The scheduled task form does not support custom cron expressions. Session timers accept cron.
- Repeating session timers expire after 7 days and need to be renewed.
- Each run uses model usage (Plus models, or the subscription / BYOK you chose).
- Without Plus you can browse the board, and creating a task first guides you to subscribe. See Without Plus.