Skip to main content
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, 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: 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.
  • 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.
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

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.

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.