Skip to main content
Cron routines fire on a repeating schedule using standard cron expressions. Use them for any task that should happen at a predictable time — daily reports, weekly cleanups, hourly checks.

​
Creating a Cron Routine

Describe the schedule and task to the agent. It will call routine_create on your behalf: 
Create a routine that runs every weekday at 9am and summarizes
what I worked on yesterday by reading my daily notes, then
writes a standup draft to memory at daily/standup.md.

​
Execution Model

When a cron routine fires:
  1. The routine engine creates a new agent job with the action prompt
  2. The job runs through the full agent loop — LLM reasoning, tool calls, safety layer
  3. Output is written to memory or sent via a channel notification (if configured)
  4. The run is recorded in routine history, accessible via routine_history
Routine jobs run as standard jobs and count against MAX_PARALLEL_JOBS. If the limit is reached when a cron fires, the routine job queues as Pending.

​
Configuration

# Enable routines
ROUTINES_ENABLED=true

# Cron tick interval (how often the engine checks for due jobs)
ROUTINES_CRON_INTERVAL=60    # seconds

# Max routines running simultaneously
ROUTINES_MAX_CONCURRENT=3