schedule command manages scheduled agent execution.
Usage
Commands
| Command | Description |
|---|---|
add | Add a scheduled job |
start | Start scheduled agent execution |
stop | Stop scheduled job(s) |
list | List scheduled jobs |
logs | View scheduler logs |
restart | Restart a scheduled job |
delete | Delete a scheduled job |
describe | Show job details |
stats | Show scheduler statistics |
Adding Jobs
Options
| Option | Short | Description |
|---|---|---|
--schedule | -s | When to run: hourly, daily, */30m, cron:..., at:..., in 20 minutes |
--message | -m | Prompt text to deliver |
--agent | -a | Agent ID to execute this job (default: first registered) |
--channel | Delivery platform: telegram, discord, slack, whatsapp, email, agentmail | |
--channel-id | Target chat/channel ID | |
--session-id | Session ID to preserve conversation context | |
--json | Output JSON |
Examples
Add a daily reminder bound to a specific agent
Add with delivery target
Start scheduler
List scheduled jobs
View logs
Stop a job
Delete a job
See Also
- Scheduler - Scheduler details
- Background - Background tasks

