Scheduling

Agent HQ supports scheduling tasks for future execution and setting up recurring tasks that run on a cron schedule.

Scheduled tasks

Set a scheduled_at timestamp on any task to defer its execution to a specific date and time. The task sits in the backlog until the scheduled time, then automatically moves to the queue for execution.

This is useful for:

• Running tasks during off-hours
• Scheduling deployments or maintenance tasks
• Deferring non-urgent work

Recurring tasks

Set a recurrence cron expression on a task to have it execute repeatedly. Agent HQ uses standard cron syntax:

# Every day at 9am UTC
0 9 * * *

# Every Monday at 8am UTC
0 8 * * 1

# Every 6 hours
0 */6 * * *

Each recurrence creates a new execution while preserving the task definition. The last_run_at field tracks when the task last executed.

Use cases

Daily code quality checks

Schedule a recurring task to run linting, tests, or security scans on your codebase every morning.

Automated reports

Set up a weekly task that analyzes your repository and generates a summary of changes, test coverage, or dependency updates.

Maintenance tasks

Schedule tasks for dependency updates, database cleanup, or other routine maintenance during low-traffic hours.

Managing scheduled tasks

Scheduled and recurring tasks appear on the task board like any other task, with an indicator showing when they’re scheduled to run next. You can edit the schedule or cancel recurrence at any time by modifying the task.