Oko/Docs

Command reference

oko claims review

Starts the adversarial reviewer a claim needs: a new agent session, as `oko sessions start` starts one, on a route that is neither the author's model nor provider, in the claim's repository checkout. Its first prompt hands it the defect (title, evidence, repair plan), the claimed revision and assertion, asks it to reproduce the original failure on the installed build, find inputs or states in which it still occurs, check the change removed the cause at every place the mechanism lives and that the real test exercises the product, and to record exactly one `oko claims verify <id> --kind adversarial` verdict with its route.

Invocation#

Command
oko claims review <id> --model PROVIDER/MODEL [--cwd DIR] [--json]

Inputs and options#

  • --model is the reviewer's route as `<provider>/<model>`; --cwd names the checkout when the claim's revision names no repository of this workspace.

Output and state effect#

  • Prints the started session as `oko sessions start` does (with --json its session, transcript, terminal id and attach command). Oko Desktop → Defects → Claims starts the same reviewer; the native API answers it as `claims` `review {id, model, cwd}`.

Refusals and safe exits#

  • `oko claims review --model takes <provider>/<model>, as sessions start does; got <route>` (exit 2); `claim <id> was made on model <m>; an adversarial reviewer runs on another model` and the same for the provider; `claim <id> names no repository in <revision>; name the checkout with --cwd`; the refusals of `oko sessions start`.

CLI reference#