Skip to main content

Scheduled tasks

Scheduled tasks run recurring work on your behalf. Open Run → Scheduled tasks when the feature is enabled (depends on sessions / agents capability in the deployment).

Create a task

  1. Name the task and write instructions (what the agent should do each firing).
  2. Choose project, provider/model, and mode (Plan, Ask, Agent, …).
  3. Pick a target:
    • Session (default) — each firing creates a fresh interactive-style session
    • AgentRun — queues a headless run against an existing agent definition
  4. Set recurrence: either interval minutes (from startAtUtc) or a cron expression + time zone.
  5. Optionally allow-list knowledge bases and MCP servers, attach a GitHub repo, and set budgets / overlap policy.

Control

ActionEffect
Pause / ResumeStop or continue future firings
Run nowTrigger an occurrence immediately
OccurrencesInspect history, reports, cancel a live run

Every occurrence ends with a markdown report (including failed/cancelled runs). Prefer overlapPolicy: Skip unless you intentionally allow concurrent work.

Tips

  • Start in Plan mode for exploratory sweeps.
  • Auto-pause after consecutive failures protects spend — fix the cause before resuming.
  • Empty KB/MCP allow-lists usually mean “no extra restriction”; set explicit IDs to lock scope.