Skip to main content
Cron jobs let Nagare automatically run a request on a schedule, for example “every morning at 9 AM, tell me the weather”.

Create a cron job

You simply tell Nagare in conversation:
Nagare uses the create_cronjob_tool with three parameters:

Cron expressions

Use the standard 5-field cron format: minute hour day-of-month month day-of-week.

How cron jobs run

  • A cron job is attached to the chat session where it was created.
  • When the schedule triggers, the gateway sends action_description into that session as a system message, with isolated context. The result appears in that same conversation (including Telegram conversations).
  • After each run, the next run time is automatically recalculated.
Cron jobs only run while the gateway is running. If the gateway is stopped, restart it with nagare gateway start.
If the task involves a tool that requires approval, you still need to approve it on every run. See Tool Approval.