---
updatedAt: 2026-06-01T19:11:52.000Z
agentTools:
  projectIndex: https://docs.bigeye.com/llms.txt
---

# Job Scheduling

Schedule recurring agent tasks with cron jobs

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

```bash
./bigeye-agent jobs list
```

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

### Create or Update a Job

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

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

| Option         | Description                                                          |
| -------------- | -------------------------------------------------------------------- |
| `--name`, `-n` | Name of the job to create or update. If omitted, you'll be prompted. |

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

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

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

| Option         | Description                                                |
| -------------- | ---------------------------------------------------------- |
| `--name`, `-n` | Name of the job to delete. If omitted, you'll be prompted. |

## Syncing Jobs

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