Job Scheduling

The Agent CLI includes a built-in job scheduler for automating recurring agent tasks. Jobs are defined with a cron schedule and a command to execute.

Commands

List Jobs

./bigeye-agent jobs list

Lists all scheduled jobs with their names, schedules, and commands.

Create or Update a Job

# Interactive — prompts for name, schedule, and command
./bigeye-agent jobs upsert

# Specify the job name
./bigeye-agent jobs upsert -n my-lineage-job

You'll be prompted for:

1. Job name (if not provided via --name)
2. Cron schedule (e.g., 0 2 * * * for daily at 2 AM)
3. Command to execute (e.g., ./bigeye-agent lineage run -c snowflake)

If a job with the given name already exists, it will be updated with the new schedule and command.

Remove a Job

# Interactive — prompts for job name
./bigeye-agent jobs remove

# Specify the job name
./bigeye-agent jobs remove -n my-lineage-job

Syncing Jobs

Jobs are managed alongside the rest of your agent configuration. When you run ./bigeye-agent sync, job schedules are also reconciled.