Oko
Oko/Docs

Command reference

oko tasks held

Answers the tasks a session claimed in the shared ledger and has shown nothing for: no evidence recorded and no verdict of done. Tama's block-stop-with-claimed-work asks it to refuse ending a turn of that session while any is left.

Invocation#

Command
oko tasks held --by <session> [--json]

Inputs and options#

  • --by names the session whose claims are read. Three filtered reads answer it — the session's claims, the evidence and the done verdicts recorded for those tasks — so no session's whole ledger is read.

Output and state effect#

  • Prints `<task-id> <session key> #<number> claimed <time>` per held task, oldest claim first, or `<session> holds no claimed task without evidence`; --json prints [{task, session, ordinal, claimedAt}]. Reads only.

Refusals and safe exits#

  • `oko tasks held requires --by <text>`; a flag other than --by and --json is refused by name (exit 2); a blank --by names what is missing; a claim row without its task, session or number is refused naming the row; the database refusals of the shared ledger name the failed read.

CLI reference#