openplanr delegate
Hand one scoped implementation to Claude Code, Codex or Cursor, then review and integrate its changes
openplanr delegate [options] [command]Commands
probeDiscover Git, installed Claude Code, Codex and Cursor CLIs, and saved profiles
profile-previewShow the destination and readiness of a profile before saving it
profile-enrollSave a previewed profile after its destination is confirmed
profile-removeRemove a saved profile by name
prepareBuild the context capsule and owned worktree, and return the preview to confirm
prepare-worktreeRun parent-selected setup commands in the owned worktree before dispatch
dispatchStart the native agent for a prepared run
waitWait a bounded time for a running delegate, then report its state
statusReport a run, its session, progress and saved report
resumeContinue the recorded session with an answer or correction
recoverReconcile a run whose process ended without recording an outcome
closeClose a run record with a disposition
cleanupRemove an owned worktree that holds no unreviewed work
abandonDiscard a run that never executed, keeping any modified work
pruneDelete closed run records past their retention
integrateReview, apply or recover the observed patch of a finished run
Notes
Every action prints { ok, action, contract, result, next } with --json, or
{ ok: false, code, problem, recovery } with exit code 1. See docs/CLI.md.openplanr delegate probe
Discover Git, installed Claude Code, Codex and Cursor CLIs, and saved profiles
openplanr delegate probe [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate probe --json
openplanr delegate profile-preview
Show the destination and readiness of a profile before saving it
openplanr delegate profile-preview [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate profile-enroll
Save a previewed profile after its destination is confirmed
openplanr delegate profile-enroll [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate profile-remove
Remove a saved profile by name
openplanr delegate profile-remove [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate prepare
Build the context capsule and owned worktree, and return the preview to confirm
openplanr delegate prepare [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate prepare --input prepare.json --json
openplanr delegate prepare-worktree
Run parent-selected setup commands in the owned worktree before dispatch
openplanr delegate prepare-worktree [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate dispatch
Start the native agent for a prepared run
openplanr delegate dispatch [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate dispatch --run <runId> --json
openplanr delegate wait
Wait a bounded time for a running delegate, then report its state
openplanr delegate wait [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate wait --run <runId> --json
openplanr delegate status
Report a run, its session, progress and saved report
openplanr delegate status [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate status --run <runId> --json
openplanr delegate resume
Continue the recorded session with an answer or correction
openplanr delegate resume [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example:
echo '{"runId":"<runId>","correction":"Fix the failing test."}' | openplanr delegate resume --input - --jsonopenplanr delegate recover
Reconcile a run whose process ended without recording an outcome
openplanr delegate recover [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate close
Close a run record with a disposition
openplanr delegate close [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate cleanup
Remove an owned worktree that holds no unreviewed work
openplanr delegate cleanup [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate abandon
Discard a run that never executed, keeping any modified work
openplanr delegate abandon [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate abandon --run <runId> --json
openplanr delegate prune
Delete closed run records past their retention
openplanr delegate prune [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
openplanr delegate integrate
Review, apply or recover the observed patch of a finished run
openplanr delegate integrate [options] [command]openplanr delegate integrate review
Review the observed patch against the integration scope; nothing is applied
openplanr delegate integrate review [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example:
echo '{"runId":"<runId>","scopePaths":["src"]}' | openplanr delegate integrate review --input - --jsonopenplanr delegate integrate apply
Run the selected checks and apply the reviewed patch as an uncommitted diff
openplanr delegate integrate apply [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |
Notes
Example: openplanr delegate integrate apply --input apply.json --json
openplanr delegate integrate recover
Finish or roll back an interrupted apply
openplanr delegate integrate recover [options]| Option | Description |
|---|---|
--input <file> | JSON object with the action fields; "-" reads stdin |
--run <runId> | run identifier; merged into the input as runId |
--json | machine-readable output |