Interval Scheduling
Interval Scheduling lets the agent re-run a prompt on a fixed cadence — every N minutes, as long as the scheduler is armed.
How It Works
Arm the interval scheduler in the composer, set the interval in minutes. The agent will:
Tick → (idle? launch prompt : skip) → repeat every N minutes
Each tick launches a fresh run of the configured prompt. If the agent is still busy when a tick fires, that tick is skipped and the next one is scheduled as usual.
You can stop at any time — the scheduler disarms cleanly and the in-flight run (if any) continues normally.
Controls
Click the Interval button next to the composer to open settings:
| Control | What it does |
|---|---|
| Interval switch | Arm/disarm the scheduler for this session |
| Interval (minutes) | Cadence in minutes (1–1440) |
While the scheduler is armed, the interval badge in the toolbar shows a live countdown to the next tick, the launch count, and Run now / Stop controls.
Interval Events
The relay emits these events while the scheduler is active:
| Event | When |
|---|---|
interval_armed | Scheduler armed (minutes, next tick) |
interval_launched | A tick launched a new run |
interval_skipped | A tick was skipped because the session was busy |
interval_stopped | Scheduler disarmed |
When Interval Scheduling Excels
- Monitoring — re-run a status check or test suite every 30 minutes
- Periodic maintenance — refresh docs, update a report, sync a dashboard
- Batch work — process a queue of tasks in a steady, predictable cadence
Best Practices
- Pick a cadence that matches the work — 5 minutes for tight loops, 60+ for slow monitoring
- Keep the prompt idempotent — it will run repeatedly, so it should be safe to re-run
- Check in periodically — review results between ticks