Command reference
oko sessions read
Reads each named session, or every live one, from where its last reading ended, and keeps the reading for every supervisor to read instead of the transcript.
Invocation#
oko sessions read [ID …] [--socket PATH]Inputs and options#
- Readings are kept in ~/.oko/readings, one file per session; OKO_READINGS_DIR moves them. The model policy pass reads every live session at each pass.
Output and state effect#
- Prints {readings: [{session, at, since, until, transcript, state, runningTool, stoppedOn, failed, waits, commits, toOperator, posts, places, seconds}], seconds: {list, read}}: every reading of one run carries the same at, which a supervisor's send or role change cites with --reading. A session whose transcript cannot be read is answered {session, at, failed} and keeps its last reading. `oko sessions digest` names the last reading's at and until and, when it can no longer be cited, why (reading.stale).
Refusals and safe exits#
- “oko sessions read: no session <id> is listed; `oko sessions agents` lists them”, and a listing the broker cannot answer.