Skip to content
Wayland Docs

Schedule Tasks (Cron)

A scheduled task runs on a clock: a skill that fires each morning, a status command on a regular interval, or a message posted to a channel on a cadence. The desktop has a scheduler page, and the engine exposes the same jobs through the cron command.

Open the scheduler

Section titled “Open the scheduler”

Open the Scheduled Tasks page. It lists every job with its schedule, target, and current state.

The Scheduled Tasks page

Create a task

Section titled “Create a task”
  1. Open the create-task dialog.
  2. Give the task a name, and write the prompt: the instructions the agent runs each time the task fires.
  3. Set the schedule, with the frequency picker (hourly, daily, weekly, weekdays) or a custom cron expression. For example, 0 8 * * 1 is every Monday at 08:00.
  4. Choose the agent that runs it, and optionally set the execution mode, workspace, and model.
  5. Save.

Manage tasks

Section titled “Manage tasks”

From the list you can enable or disable a task without deleting it. A disabled task stays on disk and is skipped until you turn it back on. Open a task to see its detail, including its recent runs.

The same from the CLI

Section titled “The same from the CLI”

The engine’s cron command manages the same jobs:

Terminal window
wayland-core cron add "0 9 * * *" --skill morning-brief
wayland-core cron add "0 8 * * 1" --channel team --text "Good morning"
wayland-core cron add "*/15 * * * *" --slash "/status"
wayland-core cron list
wayland-core cron disable <id>

Jobs persist to $WAYLAND_HOME/cron/jobs.json. A background runner started at session boot picks up changes on its next tick. To keep jobs running without an open session, the engine can run the cron runner as a detached daemon.

Next

Section titled “Next”