aigon schedule
Defer a kickoff to a specific clock time. The aigon server (aigon server start) polls the schedule store every ~45 seconds and fires each job once at or after its --run-at. If the server is offline at that moment, the job stays pending and fires on the next poll after the server starts (catch-up: it fires once when runAt <= now).
aigon schedule add feature_autonomous <id> --run-at=<iso8601> <agents...> [options]
aigon schedule add set_autonomous <slug> --run-at=<iso8601> <agents...> [options]
aigon schedule add research_start <id> --run-at=<iso8601> [agents...] [options]
aigon schedule list [--all] [--repo=<path>]
aigon schedule cancel <jobId> [--repo=<path>]The server is a hard requirement — without it, scheduled jobs never fire.
add feature_autonomous
Queue a feature-autonomous-start for a future time.
aigon schedule add feature_autonomous 142 \
--run-at=2026-04-28T09:30:00-07:00 cc \
--stop-after=eval --eval-agent=ag| Flag | Meaning |
|---|---|
--run-at=<iso8601> | Required. Must include an explicit timezone (Z or ±hh:mm). |
--stop-after= | implement | eval | review | close (forwarded to feature-autonomous-start). |
--eval-agent=<id> | Agent for the eval phase. |
--review-agent=<id> | Agent for the code-review phase. |
--workflow=<slug> | Workflow definition slug. |
--models=<csv> | Per-agent model overrides (e.g. cc=claude-opus-4-7,ag=gemini-3.5-flash-medium). |
--efforts=<csv> | Per-agent effort overrides. |
--review-model=<id> / --review-effort=<id> | Review-phase overrides. |
--repo=<path> | Target repo (defaults to current). |
add set_autonomous
Queue a set-autonomous-start for a future time. At run time the scheduler dispatches the existing set conductor — ordering, failure pauses, resume, and reset semantics stay in SetConductor.
aigon schedule add set_autonomous nightly \
--run-at=2026-06-19T09:00:00Z cx ag \
--review-agent=cc --stop-after=close| Flag | Meaning |
|---|---|
--run-at=<iso8601> | Required. Must include an explicit timezone (Z or ±hh:mm). |
--review-agent=<id> | Agent for per-member code review (forwarded to set-autonomous-start). |
--models=<csv> | Per-agent model overrides. |
--efforts=<csv> | Per-agent effort overrides. |
--stop-after=close | Only close is supported for set autonomous runs. |
--repo=<path> | Target repo (defaults to current). |
add research_start
Queue a research-start.
aigon schedule add research_start 12 \
--run-at=2026-04-29T08:00:00Z cc ag --background| Flag | Meaning |
|---|---|
--run-at=<iso8601> | Required. Must include an explicit timezone. |
--background / --foreground | Forwarded to research-start. |
--repo=<path> | Target repo. |
list
Print pending jobs in the schedule store. Pass --all to include completed and cancelled jobs as well.
cancel <jobId>
Cancel a pending job by its id (printed by add and list). Already-fired jobs cannot be cancelled.
How it’s stored
Scheduled jobs live in .aigon/state/scheduled-kickoffs.json (lock-protected, store version 1). The store lives under .aigon/state/ and travels with the rest of your portable Aigon data — see Aigon Sync for pushing that state to a private vault across machines.
See also
feature-autonomous-start— what afeature_autonomousjob actually runs.set-autonomous-start— what aset_autonomousjob actually runs.research-start— what aresearch_startjob runs.server— required to fire scheduled jobs.