Skip to content
Schedules

CLI

Add schedules and synchronize files with a harness.

Commands

npx agent-schedules add <owner/repo[/name]>
npx agent-schedules pull <t3|codex|claude|pi>
npx agent-schedules push <t3|codex|claude|pi>
npx agent-schedules doctor

add copies a schedule from a public GitHub repository into .agents/schedules/. Then push it to register it with a harness.

doctor reports what each harness has without changing anything. For the Codex app it shows whether each pushed file has reached the app's own database, which is what the app actually schedules from.

Repository and home folder

In a repository, files are stored in that repository's .agents/schedules/ directory and tasks run in the repository. Outside a repository, files are stored in ~/.agents/schedules/ and run in your home folder. Use --global to select the home folder while inside a repository.

Dry runs and telemetry

Add --dry-run to preview changes without writing files or registering an install. Set DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable install telemetry.