Oko/Docs

Command reference

oko-cli routines inspect

Reads Stado's actual job state and verifies its canonical Oko result.

Invocation#

Command
oko-cli routines inspect JOB_ID [--json]

Inputs and options#

  • A job ID from a scheduled occurrence or manual submission.

Output and state effect#

  • Terminal jobs download canonical artifacts under ~/.oko/routines/results/<job-id>. Oko validates the receipt's job and definition identity.
  • Shows context source states/documents or autonomy disposition and accepted Pursuit receipt; process completion alone is not Oko success.

Refusals and safe exits#

  • Foreign/malformed job identity fails. Missing or mismatched output remains artifactError with a nonzero exit; failed jobs retain Stado's actual error.

CLI reference#