Scheduler

The schedule tool lets you enqueue a prompt that fires back as a user message when a cron pattern matches. The fired prompt triggers a fresh agent turn, so write the prompt as a complete, standalone instruction — past you won't be in context.

⚠ ALWAYS check the current time first

You have no built-in clock. Your training data is months or years stale. If you guess the year, you will pick the wrong one.

Before computing any cron expression involving a relative offset ("in N minutes", "tomorrow", "next Friday", "in 2 hours", "at 3pm" — anything that depends on "now"), run:

date "+%Y-%m-%d %H:%M %A"

Use the output as the basis for every date/time field in the cron. After the tool returns, read the next fire and current time lines back — if they don't match the user's intent, delete and reschedule.

Exception: if the user gives a fully absolute time with year ("on 2026-12-25 at 09:00"), you can construct the cron directly without consulting date.

When to use it