Command reference
oko instructions list
Prints the supervisor's submitted instructions to executors, newest first: one per target of every submitted defect-bound send (oko sessions send --defect --submit, the native terminal send, the standing supervision pass, review answers) and one for a new executor's first prompt from the standing supervision, audit or handover path. Typing without submission is a draft and creates no instruction.
Invocation#
oko instructions list [--session ID] [--item DEFECT] [--state STATE] [--json]Inputs and options#
- --session keeps one executor's, compared by session key; --item one defect's, by its short or whole id; --state one of sent, acted, ignored, retracted.
- The register is ~/Library/Application Support/Oko/instructions.json; OKO_INSTRUCTION_REGISTER moves it, and beside a moved OKO_DEFECT_REGISTER it is <register>.instructions.json.
Output and state effect#
- Reads only. Each instruction carries its batch (every target one send reached), target, supervisor, terminal, item, kind, text, sentAt, the target's transcript and its byte coordinate (before delivery into an existing session; at the opened transcript's initial cursor for a fresh session), state, settledAt, model evidence, supersededEvidence from any earlier token-based guess, pendingCause from the last failed judgment or transcript read, and retraction. Old acted/ignored rows without a model reason are projected as sent and pending even before the next settlement pass; Oko Desktop → Defects → Supervisor instructions shows the same standing.
Refusals and safe exits#
- A state outside the four refuses by name; an unreadable register refuses with its path and cause.