CLI Documentation

Let your AI assistant set up tasks. You stay in control with the visual timeline.

How it works: Tasks added via CLI are the same tasks you see in the Orchard Ops app — same timeline, same wake-from-sleep, same management. The CLI is an input method; the app is your control panel.

Installation

The CLI ships inside the Orchard Ops app. Install it from the menu:

Help → Install CLI Command...

This creates a symlink at /usr/local/bin/orchard-ops (requires admin password once).

Or install via Homebrew:

brew install orchardworks/tap/orchard-ops

Commands

List tasks

orchard-ops list

Shows all tasks with status, schedule, wake flag, and short ID.

Add a task

# Run a backup script every day at 3:00 AM, waking the Mac
orchard-ops add \
  --name "Backup" \
  --command "rsync -av ~/Documents /Volumes/Backup" \
  --daily 03:00 \
  --wake

# Run a scraper every 30 minutes
orchard-ops add \
  --name "Scraper" \
  --command "./scrape.sh" \
  --interval 30 \
  --working-dir /path/to/project

# Run a Python script on weekdays at 9:00 AM
orchard-ops add \
  --name "Report" \
  --command "python3 report.py" \
  --weekly mon,tue,wed,thu,fri 09:00 \
  --env-file /path/to/.env

# Run at multiple times per day
orchard-ops add \
  --name "Health Check" \
  --command "curl -f https://myapp.com/health" \
  --daily 09:00,13:00,17:00

# Run at login
orchard-ops add \
  --name "Startup" \
  --command "~/scripts/init.sh" \
  --run-at-load

Schedule options

Flag	Format	Example
`--daily`	`HH:MM[,HH:MM,…]`	`--daily 03:00` or `--daily 09:00,17:00`
`--weekly`	`days HH:MM[,…]`	`--weekly mon,wed,fri 09:00,17:00`
`--monthly`	`day HH:MM[,…]`	`--monthly 1 09:00`
`--interval`	`minutes`	`--interval 30`
`--run-at-load`	—	`--run-at-load`

Additional options

Flag	Description
`--wake`	Wake Mac from sleep before running (via pmset)
`--working-dir <path>`	Working directory for the command
`--env-file <path>`	Load environment variables from a .env file

Remove a task

orchard-ops remove "Backup"
orchard-ops remove 3ab4c22f   # by short ID

Enable / Disable

orchard-ops enable "Backup"
orchard-ops disable "Backup"

Status

orchard-ops status

Shows total tasks, enabled count, and license status.

License

orchard-ops license                    # view status
orchard-ops license activate <key>     # activate Pro

Free: up to 3 tasks. Pro ($15 one-time): unlimited.

For AI Agents

If you're an AI assistant helping a user schedule tasks on their Mac, use these commands. Every task you create will be visible in the Orchard Ops timeline and managed with full wake-from-sleep support.

Typical workflow

# 1. Check current tasks and limits
orchard-ops status
orchard-ops list

# 2. Add the task the user wants
orchard-ops add \
  --name "Daily DB Backup" \
  --command "pg_dump mydb > ~/backups/db-$(date +%Y%m%d).sql" \
  --daily 02:00 \
  --wake

# 3. Confirm it was added
orchard-ops list

Key things to know

Tasks are shared with the GUI app — the user sees them in the timeline immediately
--wake triggers macOS power management (pmset) so the Mac wakes from sleep before running
Free tier allows 3 tasks; check orchard-ops status before adding
Use --working-dir and --env-file to ensure the command runs in the right context
Task names and short IDs (first 8 chars of UUID) both work for remove/enable/disable