gratefulagents

Projects and schedules

Cron schedules

A Cron schedule is a Project Entry point that starts a run at scheduled times. Create and manage it from Project → Entry points; there is no separate Cron sidebar or detail workflow.

See Projects for the shared Entry-point lifecycle and Run defaults for the defaults each Cron run inherits.

Create a Cron Entry point

  1. Open the Project.
  2. In Entry points, select New trigger.
  3. Enter a DNS-style Name, choose Cron as the source type, then enter Schedule, optional Time zone, and Prompt.
  4. Select Create trigger.

Cron does not use a connection. Its runs inherit the Project’s repository, model, credentials, runtime, tools, policies, and custom instructions.

FieldRequiredBehavior
NameYesIdentifies this Entry point. It cannot be manual.
ScheduleYesA standard five-field cron expression or a supported descriptor such as @hourly.
Time zoneNoAn IANA time-zone name. Leave it empty to use UTC.
PromptYesThe first user message in every scheduled run.

Scheduling behavior

The default concurrency policy is Forbid: if an earlier run from the same Cron is still active, the due tick is skipped. The current Entry-point form does not expose a concurrency-policy control.

When a tick is skipped or the controller resumes after downtime, skipped times are not backfilled. A schedule or time-zone change starts from the next future matching time.

Status and lifecycle

The Entry-points rail shows the Cron’s last and next scheduled activity. Its badge is:

  • applying until the generated schedule has reported activity or a Ready condition;
  • ready when the runtime reports Ready or active scheduling;
  • degraded when it reports an error or a non-ready state; or
  • disabled when you turn off the Entry point switch.

Use the switch to disable scheduling without deleting the Entry point. Disabling removes the generated Cron runtime and stops new scheduled runs; existing runs are kept. Turn it back on to recreate the runtime.

Use Edit to change the schedule, time zone, or prompt. The source type remains Cron. Use Delete to permanently remove the Entry point; it does not delete runs already created by it.