Scheduled tasks run an agent on a recurring schedule. Each task has a cron expression, a prompt that the agent receives when the schedule fires, and optional Discord channels for output and error reporting.
Use scheduled tasks for:
- Daily standup summaries or reports
- Periodic code review reminders
- Automated monitoring checks with structured output
- Regular data pipeline triggers
Creating a Scheduled Task
Go to Settings → Agents, open the agent, then Scheduled Tasks → Add Task.
Or ask the admin agent to create one with a name, schedule, and prompt. For example:
Create a scheduled task for the “Daily Digest” — runs every weekday at 8am UTC. Prompt: summarize the team’s GitHub activity from the past 24 hours and post a digest.
Fields you set:
| Field | Description |
|---|---|
| Name | A label for this task (e.g. “Morning Digest”) |
| Schedule | A cron expression (e.g. 0 8 * * 1-5 for weekdays at 8am) |
| Prompt | The message the agent receives when the schedule fires |
| Timezone | Timezone for interpreting the schedule. Defaults to the org default if not set. |
| Default channel | Discord channel to post the response to |
| Error channel | Discord channel to notify if the task fails |
Cron Expression Format
Schedules use standard 5-field cron syntax: minute hour day-of-month month day-of-week.
Common examples:
| Expression | Meaning |
|---|---|
0 8 * * * | Every day at 8:00am |
0 8 * * 1-5 | Weekdays at 8:00am |
0 */4 * * * | Every 4 hours |
0 9 1 * * | First day of each month at 9:00am |
*/15 * * * * | Every 15 minutes |
Enabling and Disabling
Scheduled tasks can be paused without deleting them. Go to Settings → Agents, open the agent, then Scheduled Tasks and toggle the task on or off.
You can also ask the admin agent to enable or disable a named task by specifying the task name and which agent it belongs to.
Last Run and Next Run
The task list shows when each task last fired and when it will next fire. If a task fails, check the error channel (if configured) or the Explorer for the failed job.
Discord Integration
If you configure a default channel, the response is posted to that Discord channel after each run. This turns scheduled tasks into automated reports delivered directly to your team.
For this to work, the agent must have a Discord integration connected. See Discord Integration →.