Rules for every change
These rules hold in the CLI and the plugin.- Launch check. A create, a resume, or a change to the experiment,
--cron, or--time-zonefirst checks the launch as you. If anything blocks it, the command refuses withschedule_launch_blockedand lists every blocker with its fix link, the same onesoqoqo schedules previewshows. When the check passes, the schedule runs as you. - Paused schedules stay paused. A passing check clears the reason Oqoqo paused a schedule, but it stays paused until you resume it.
oqoqo schedules updateprints the resume command. - One launch at a time.
oqoqo schedules launchrefuses withexperiment_schedule_run_activewhile the schedule’s last experiment still runs. - 50 active schedules. A create or resume past that returns
schedule_limit_reached. - Lock versions. Every change after create takes the
--lock-versionfromoqoqo schedules get, so two people can’t overwrite each other’s edits; a stale value fails withschedule_changed. - Attempt IDs. Create and update take an
--attempt-id, so a retry after a lost response is the same change. Reusing an ID for a different change fails withschedule_attempt_reused.
Time zones
The cron has five fields (minute, hour, day of month, month, day of week) and always reads in the schedule’s time zone. For example,0 9 * * 1-5 is 9:00 AM on weekdays. The minute must be 0, 15, 30, or 45, so a schedule launches at most once an hour, on the quarter hour.
--time-zone (with a hyphen) takes an IANA name, such as America/New_York, or UTC. It’s required on create because AI assistants and CI machines often run in UTC, and the error suggests your machine’s time zone.
oqoqo schedules preview
Preview when a new or changed schedule launches, the runs it uses, and what would stop it.preview_schedule
Arguments
Flags
Also takes the global flags.
Examples
Preview a new weekday schedule:
Notes
The preview changes nothing and checks the launch as you. A paused schedule’s preview shows the launches it would have once you resume it.
oqoqo schedules create
Schedule a finished experiment to launch again on a cadence.manage_schedule
Each scheduled launch spends runs from your organization’s balance. In Ask Oqo, you approve each call.
Arguments
Flags
Also takes the global flags.
Examples
Launch the experiment again at 9:00 AM Pacific every weekday:
Notes
The schedule runs as you and checks the conditions under Rules for every change.
oqoqo schedules list
List the project’s schedules.list_schedules
Flags
Also takes the global flags.
Examples
Find the schedule that launched an experiment:
Notes
Text output shows
needs attention for a schedule that Oqoqo paused. To list the experiments a schedule launched, run oqoqo experiments list --schedule-id. oqoqo experiments get also names the schedule that launched an experiment, in lineage.schedule.
oqoqo schedules get
Read one schedule.get_schedule
Arguments
Takes only the global flags.
Examples
Read the
lockVersion before a change:
Notes
Text output shows the status, the cadence, the next launch in the schedule’s time zone, the runs it uses, who it runs as, the last experiment, and the lock version.
oqoqo schedules update
Change a schedule’s name, cadence, time zone, or experiment.manage_schedule
Each scheduled launch spends runs from your organization’s balance. In Ask Oqo, you approve each call.
Arguments
Flags
Pass at least one of
--name, --cron, --time-zone, or --experiment-id. Also takes the global flags.
Examples
Move a schedule to 10:00 AM:
Notes
The command changes only the flags you pass, and renaming alone doesn’t change who the schedule runs as. A change to the experiment,
--cron, or --time-zone gets the launch check; preview it first with oqoqo schedules preview --schedule-id.
oqoqo schedules pause
Pause a schedule. It does not launch until you resume it.manage_schedule
In Ask Oqo, you approve each call.
Arguments
Flags
Also takes the global flags.
Examples
Notes
Pausing a paused schedule changes nothing. See Rules for every change.
oqoqo schedules resume
Resume a paused schedule. It runs as you from its next launch time.manage_schedule
Each scheduled launch spends runs from your organization’s balance. In Ask Oqo, you approve each call.
Arguments
Flags
Also takes the global flags.
Examples
Notes
Resume runs the launch check. If something blocks it, the schedule stays paused and
details.blockers lists every blocker, with the same fields as the preview’s blockers; fix them and run the same command again. Resuming never starts a launch right away, and resuming an active schedule changes nothing.
oqoqo schedules launch
Launch the schedule’s experiment now, as you.rerun_experiment with schedule_id
This command spends runs from your organization’s balance. In Ask Oqo, you approve each call.
Arguments
Flags
Also takes the global flags.
Examples
oqoqo experiments launch: launchId, experimentId, status, runCount, and dashboardUrl. Follow the launch with oqoqo experiments watch.
Notes
The launch uses the latest tasks, under the schedule’s name, and doesn’t move the next scheduled launch. It refuses with experiment_schedule_run_active while the schedule’s last experiment still runs (see Rules for every change).
oqoqo schedules delete
Delete a schedule. The experiments it launched stay.delete_schedule
Arguments
Flags
Also takes the global flags.
Examples
Notes
Deleting a schedule that is already deleted returns
schedule_not_found.
Schedule fields
oqoqo schedules get, list, create, update, pause, and resume return these fields. oqoqo schedules preview returns the cadence, run, and shortfall fields.
In
oqoqo notifications list, a schedule’s paused, skipping, and short-of-runs notifications, and the problem notifications of the experiments it launched, carry its scheduleId. To read the runs or frictions of everything a schedule launched, pass --schedule-id to oqoqo runs list or oqoqo frictions list.
Related
Schedules
How schedules launch, who they run as, and when they pause.
Track results over time
Use a schedule to see how agents change from week to week.
oqoqo experiments
Watch the experiments a schedule launches.

