Background Jobs

Background jobs let agents work without human intervention. Schedule tasks to run at specific times or on recurring intervals.

What Are Background Jobs?

A background job is a scheduled task that triggers an agent automatically. Instead of manually starting a session and typing instructions, the job runs on a cron schedule and sends a predefined message to an agent.

Use Cases

• Daily standup reports — Every morning at 9am, pull project status and post to Slack
• Weekly analytics — Every Monday, analyze last week's data and generate a report
• Monitoring — Every hour, check server health and alert if issues found
• Content scheduling — Every day at noon, publish the next queued blog post
• Data sync — Every 6 hours, sync data between systems

Job Types

New Session is best for independent, repeating tasks. Message Session is useful when the job needs ongoing context from previous runs.

How Jobs Execute

When a job triggers:

1. The scheduler checks if the job is enabled and not already running
2. Creates a new session (or targets the existing one)
3. Sends the configured message to the agent
4. The agent processes the task
5. Results are saved in the session
6. Run history is updated with status and timing

Cron Scheduling

Jobs use cron expressions to define when they run:

Jobs run in your configured timezone.