Cron & scheduled tasks
Schedule autonomous coding jobs with xibecode cron while the gateway is running.
Cron & scheduled tasks
Schedule agent prompts to run on an interval or classic 5-field cron expression. The gateway must be running (xibecode gateway or systemd service).
Commands
xibecode cron list
xibecode cron create "every 1d" "Summarize git status and open issues" --name daily-status
xibecode cron create "30m" "Run tests and report failures"
xibecode cron create "0 9 * * *" "Morning repo health check" --deliver telegram
xibecode cron show <id>
xibecode cron pause <id>
xibecode cron resume <id>
xibecode cron remove <id>
xibecode cron edit <id> --schedule "every 2h" --prompt "…"Schedule formats
| Form | Example |
|---|---|
| Interval minutes | 30m, every 30m |
| Interval hours | 2h, every 2h |
| Interval days | 1d, every 1d |
| 5-field cron | 0 9 * * * (09:00 daily) |
| One-shot ISO | Absolute time (parsed when supported) |
Options
| Flag | Purpose |
|---|---|
--name <name> | Human label |
--deliver <target> | local | telegram | telegram:CHAT_ID |
--workdir <path> | Job working directory |
-m, --model | Pin model |
--provider | Pin provider |
--schedule / --prompt | For create/edit |
Storage
Jobs live under ~/.xibecode/cron/jobs.json. The gateway process ticks the scheduler (default ~60s).
Tips
- Set a home channel in Telegram (
/sethome) for cron delivery. - Keep prompts idempotent (safe to re-run).
- Use a dedicated workdir for production repos.
- Agent iterations for cron runs are unlimited by default — write focused prompts.
Related
- 24/7 gateway — must be started
- Agent engine — how each job executes