Run a Task Lifecycle

Create

TASK_ID=$(orbit task add \
  --title "Update docs for policy profiles" \
  --description "Document how fsProfile selection works for activity YAML." \
  --acceptance-criteria "The docs explain explicit and implicit fsProfile resolution." \
  --acceptance-criteria "The docs include a policy YAML example." \
  --workspace .)

Inspect

orbit task show "$TASK_ID"
orbit task lint "$TASK_ID"

Attach Artifacts

Store generated notes, reports, or other UTF-8 task outputs with the task:

orbit task artifact put "$TASK_ID" ./summary.md --path reports/summary.md
orbit task show "$TASK_ID" --fields artifacts

Approve

If the task is proposed, approve it:

orbit task approve "$TASK_ID"

Execute

orbit run ship "$TASK_ID"

Use local mode when PR creation is not desired:

orbit run ship --mode local "$TASK_ID"

Review

Inspect the resulting diff, CI, task state, and audit events before approving a task out of review.

orbit task show "$TASK_ID"
orbit audit list