v1.20Grok Build CLI support →

Schedule agents

Recurring background work on a cron, plus one-shot runs scheduled at a wall-clock time. The scheduler auto-starts the first time you add a routine — no daemon to babysit.

Recurring (cron)

agents routines add standup \
    --schedule "0 9 * * 1-5" \
    --agent claude \
    --prompt "Draft a standup from yesterday's git log"

Standard 5-field cron expressions. The routine runs in the background under the same auth and resource layers as an interactive agents run — skills, MCP servers, secrets, and pinned versions all apply.

One-shot

agents routines add deploy-check \
    --at "14:30" \
    --agent codex \
    --prompt "Verify the staging deploy at https://staging.example.com"

Use --at "14:30" for a single run today, or a full ISO timestamp for a future date. Once it fires, the routine is removed.

Manage

agents routines list           # see what's scheduled
agents routines run standup    # fire it now, out of cycle
agents routines logs standup   # tail the last run
agents routines remove standup

Coming soon

Full reference — timezones, missed-fire policy, max-runtime, per-routine secret bundles, on-failure hooks. For now see agents routines --help.

Related: Hooks, Secrets, Sessions.

Want this page sooner? Open an issue.