oz schedule — schedule agents on a cron

Create, list, update, pause, and delete scheduled Oz agents. Use standard 5-field cron syntax to run an agent automatically at any interval or time.

Scheduled agents run a cloud agent automatically on a cron schedule — for example, every night, every Monday morning, or every hour. The oz schedule command lets you create and manage these schedules. As a shorthand, running oz schedule without a subcommand is equivalent to oz schedule create.

Synopsis

oz schedule [subcommand] [flags]

Running oz schedule without a subcommand acts as a shorthand for oz schedule create — it accepts all the same flags as create.

Subcommands

Subcommand	Description
create	Create a new scheduled agent
list	List all scheduled agents
get <schedule_id>	Get a scheduled agent’s configuration
update <schedule_id>	Update a scheduled agent
pause <schedule_id>	Pause a scheduled agent
unpause <schedule_id>	Resume a paused scheduled agent
delete <schedule_id>	Delete a scheduled agent

---

oz schedule create

Creates a new scheduled agent. You must supply --name, --cron, and either --prompt or --skill.

oz schedule create --name <name> --cron <expr> --prompt <text> [flags]

Shorthand: oz schedule --name <name> --cron <expr> --prompt <text>

Flags

--name · string · required

Name of the scheduled agent.

--cron · string · required

Cron schedule expression that controls when the agent runs. Uses standard 5-field cron syntax: minute hour day-of-month month day-of-week.

--prompt · string

Prompt describing what the scheduled agent should do. Mutually exclusive with --skill when used alone (both can be combined).

Short form: -p

--skill · string

Skill to automate on a schedule. Format: repo:skill_name or org/repo:skill_name. The skill is resolved at runtime in the agent’s cloud environment. Can be combined with --prompt so the skill provides the base context and the prompt adds a specific task.

--model · string

Override the base model used for runs of this schedule.

--environment · string

Cloud environment to run the scheduled agent in, identified by environment ID.

Short form: -e

--no-environment · boolean

Run the scheduled agent without a cloud environment.

--mcp · string

MCP server to configure for this schedule. Accepts a path to a JSON config file or inline JSON. Repeatable.

--host · string

Where the job should be hosted. Set to warp (or omit) to run on Warp’s infrastructure. Any other value is matched against a self-hosted worker name.

Cron syntax reference

Expression	Meaning
0 9 * * 1	Every Monday at 9:00 AM UTC
0 0 * * *	Every day at midnight UTC
0 */6 * * *	Every 6 hours
30 8 1 * *	At 8:30 AM on the first of every month
0 9 * * 1-5	Weekdays at 9:00 AM UTC

Cron times are interpreted in UTC. Adjust the expression if you need runs at a specific local time.

Examples

# Run a triage agent every weekday morning
oz schedule create \
  --name "daily-issue-triage" \
  --cron "0 9 * * 1-5" \
  --prompt "Triage and label all new GitHub issues opened in the last 24 hours" \
  --environment env_abc123

# Run a skill on a weekly schedule
oz schedule create \
  --name "weekly-dependency-update" \
  --cron "0 10 * * 1" \
  --skill owner/my-repo:dependency-update \
  --environment env_abc123

# Shorthand: oz schedule behaves like oz schedule create
oz schedule \
  --name "nightly-test-run" \
  --cron "0 2 * * *" \
  --prompt "Run the full test suite and open a PR if any tests are failing" \
  --environment env_abc123

---

oz schedule list

Lists all scheduled agents configured in your account.

oz schedule list

Examples

oz schedule list
oz schedule list --output-format json

---

oz schedule get

Retrieves the configuration for a specific scheduled agent.

oz schedule get <schedule_id>

Arguments

Argument	Description
schedule_id	ID of the schedule to retrieve

Examples

oz schedule get sched_abc123

---

oz schedule update

Updates a scheduled agent. Only the fields you specify are changed.

oz schedule update <schedule_id> [flags]

Arguments

Argument	Description
schedule_id	ID of the schedule to update

Flags

--name · string

New name for the scheduled agent.

--cron · string

New cron expression.

--prompt · string

New prompt for the scheduled agent.

Short form: -p

--skill · string

New or updated skill specification. Cannot be combined with --remove-skill.

--remove-skill · boolean

Remove the skill from this scheduled agent. Cannot be combined with --skill.

--model · string

Override the base model.

--environment · string

New environment ID.

Short form: -e

--remove-environment · boolean

Remove the environment from this scheduled agent.

--mcp · string

MCP server to add. Repeatable.

--remove-mcp · string

Remove an MCP server by its server name. Repeatable.

--host · string

Update the hosting target.

Examples

# Change the cron schedule
oz schedule update sched_abc123 --cron "0 10 * * 1-5"

# Update the prompt
oz schedule update sched_abc123 \
  --prompt "Triage issues and also check for stale PRs"

# Swap out the model
oz schedule update sched_abc123 --model claude-opus-4

# Remove the skill and add a plain prompt instead
oz schedule update sched_abc123 \
  --remove-skill \
  --prompt "Run the full test suite"

---

oz schedule pause

Pauses a scheduled agent. A paused agent still exists but will not run according to its schedule until you unpause it.

oz schedule pause <schedule_id>

Examples

oz schedule pause sched_abc123

---

oz schedule unpause

Resumes a paused scheduled agent. The agent will resume running on its previously configured schedule.

oz schedule unpause <schedule_id>

Alias: oz schedule resume

Examples

oz schedule unpause sched_abc123
oz schedule resume sched_abc123

---

oz schedule delete

Permanently deletes a scheduled agent.

oz schedule delete <schedule_id>

Examples

oz schedule delete sched_abc123