For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cron & Scheduling

Recurring jobs, one-off reminders, and scheduled agent runs - first-class.

Scheduling is a first-class capability, not a workaround. The agent can set up recurring jobs ("every weekday at 9am, summarise my inbox"), one-off reminders ("nudge me about this in three hours"), and arbitrary agent runs on a cron schedule.

Tools in the family

Tool
What it does

cron_add

Create a new scheduled job - cron expression + agent prompt.

cron_list

List existing jobs and their next-run times.

cron_update

Edit an existing job - change schedule, prompt, or enabled state.

cron_remove

Delete a job.

cron_run

Run a job once, immediately, regardless of its schedule.

cron_runs

Inspect the recent run history - when, how long, what it produced.

There's also a one-shot schedule tool in System & Utilities for "do this once at time T" cases that don't need a recurring entry.

What it's good for

  • Daily / weekly digests delivered to your messaging channel of choice.

  • Polling a slow integration that doesn't push events.

  • Reminders the agent itself owns ("remind me Thursday to follow up with Alice").

  • Recurring research - "every Monday, check what's new on this topic and write me a brief".

How it ties back to the rest

Every cron run is just a normal agent invocation, so it can use any other tool - search the web, query the Memory Tree, call a third-party integration, send a message. Run history is recorded so you can see what each tick produced.

See also

Last updated