Oko/Docs

Command reference

oko purgatory status

Reads whether one session is held: it is while a standing verdict of the operator on it is answered by no self-criticism of that session. Tama's `block-tools-in-purgatory` reads this before every tool call of a session.

Invocation#

Command
oko purgatory status --session ID [--json]

Inputs and options#

  • --session, the session's id.

Output and state effect#

  • Reads only. The JSON carries `held`, `rule`, `verdicts` (each with `answeredBy` once a self-criticism answers it), `confessions` and `withdrawn`.

Refusals and safe exits#

  • `oko purgatory requires --session <text>` (exit 2); `a self-criticism needs the session it judges` for a blank one.

CLI reference#