> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled tasks and session timers: run automatically on a schedule

> Scheduled tasks let the Agent run instructions automatically on the cloud server on a schedule. Session timers let the Agent continue working in a session at a set time. This page covers creating tasks, the confirmation card, session timers, renewal, failures, and auto-pause.

AIHubMix Cloud has two kinds of schedules:

* **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.

Both kinds appear on the **Scheduled** board. Schedules still run on the cloud server when the app or web page is closed. Running scheduled tasks requires [Plus](https://docs.aihubmix.com/en/cloud/plus/plus-plan.md), and they are supported in the desktop app, web app, and mobile web.

## 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+P` on 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:

| Action | Description |
| - | - |
| **Run now** | Runs it once right away. Cannot be clicked while the previous run is still going |
| **Renew** | Only for repeating session timers. Extends it by 7 days |
| **Pause** / **Resume** | After pausing, it no longer runs on schedule |
| Edit (pencil icon) | Opens **Edit scheduled task**. Session timers cannot be edited |
| Delete (trash icon) | Deletes after confirmation |

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

1. 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.
2. In the text box, write what to run on a schedule.
3. 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.
4. Choose **Repeat**, then fill in the time for that repeat option (see the table below).
5. (Optional) Expand **Advanced** to adjust other settings.
6. Click **Create**. It shows **Scheduled · next run X**.

| Repeat | What to fill in |
| - | - |
| Once | **Date** (within 7 days from today) + **Time** |
| Daily | **Time** |
| Weekdays | **Time** (Monday to Friday) |
| Weekly | **Day** + **Time** |
| Fixed interval | **Run every**: 15 min, 20 min, 30 min, 1 h |

* **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

| Setting | Options | Default |
| - | - | - |
| Notifications | All updates (notifies on completion and failure) / Important updates (notifies only on failure) / Off | Important updates |
| New chat for each run | When off, every run continues in the same session | On |
| Harness / Model / Effort | The same options as for a new session | Your choice from the last new session |

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.

A draft left unhandled for a while expires.

## 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

| Situation | Result |
| - | - |
| The previous run is still going | This run is skipped. **Run now** cannot be clicked during this time |
| A single failure | The failure reason is recorded and you are notified according to your notification setting. The next run happens as usual |
| 3 failures in a row | Auto-paused. See the next section |
| The app or web page is closed | Runs as usual. Check the results in the session and runs afterwards |
| No Plus, or the subscription is inactive | You cannot **Run now** or **Resume**. The interface prompts you to subscribe or renew |
| The cloud server is not running | You cannot **Run now** |

## 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](https://docs.aihubmix.com/en/cloud/plus/without-plus.md).

## FAQ

### Do scheduled tasks still run after I turn off my computer?

Yes. Scheduled tasks run on the cloud server, regardless of whether your device is on.

### Why was my scheduled task paused?

You may have paused it manually, or it failed 3 times in a row and was paused automatically. A session timer may also have expired. Check the runs to find the reason, fix it, and click **Resume** (for expired timers, **Renew** first).

### Can the Agent create schedules without my approval?

Session timers, yes: the Agent can create them directly in the current session, a record line is left in the timeline, and you can turn them off or delete them in the top bar panel. Project scheduled tasks, no: the Agent can only draft them, and you must click **Create** on the confirmation card.

### Should I use a session timer or a scheduled task?

Use a session timer when the work needs to continue with the context of the current session. Use a scheduled task when it needs to run independently in a project on a long-term schedule.

## Related

* [Without Plus](https://docs.aihubmix.com/en/cloud/plus/without-plus.md)
* [Cloud server overview](https://docs.aihubmix.com/en/cloud/cloud-host/overview.md)
* [Harness and models](https://docs.aihubmix.com/en/cloud/models/harness-and-models.md)
* [Notification settings](https://docs.aihubmix.com/en/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.