A self-describing CLI for OmniPlan 4 on macOS. Every command prints JSON and documents its own inputs and outputs, so an LLM agent can drive it as a shell tool.
- macOS with OmniPlan 4 running
- Go 1.22+ (to build)
- Automation permission granted to your terminal (System Settings → Privacy & Security → Automation)
go build -o omniplan-cli ./cmd/omniplan
# optional: move onto PATH
mv omniplan-cli /usr/local/bin/Get the full command catalog as JSON in one call:
omniplan-cli schemaEach entry has: command, description, params (name, type, required, default, description), and output (shape hint). Every command also supports --help.
| Command | Description |
|---|---|
omniplan-cli schema | Emit the machine-readable JSON catalog of all commands |
omniplan-cli document list | List all currently open OmniPlan documents |
omniplan-cli task query | Search/filter tasks by keyword, type, completion, or due date |
omniplan-cli task get | Get full details of a task by ID |
omniplan-cli task create | Create a task under a parent or the root |
omniplan-cli task update | Update task fields (only provided flags change) |
omniplan-cli task delete | Delete a task by ID |
omniplan-cli task set-effort | Set effort (hours) for a task |
omniplan-cli task link | Create a Finish-to-Start dependency |
omniplan-cli task unlink | Remove a dependency |
omniplan-cli task deps | List prerequisites and dependents |
omniplan-cli resource list | List all resources |
omniplan-cli resource create | Create a human resource |
omniplan-cli resource update | Update a resource |
omniplan-cli resource delete | Delete a resource and its assignments |
omniplan-cli resource assign | Assign a resource to a task |
omniplan-cli resource unassign | Remove a resource assignment |
omniplan-cli resource assignments | List a task's assignments |
All task/resource commands operate on the frontmost open OmniPlan document.
- Success: compact JSON to stdout, exit 0.
- Failure:
{"error":"<message>"}to stderr, non-zero exit.
omniplan-cli task create --title "Beta Launch" --type milestone --parent-id 12
omniplan-cli task query --completed=false --due-before 2026-01-01 --detail full
omniplan-cli resource assign --task-id 42 --resource "Alice Smith" --units 0.5MIT
