Oko/Docs

Command reference

oko-cli transcripts messages

Prints every operator message of a session, in order and verbatim.

Invocation#

Command
oko-cli transcripts messages (--open [--hours N] | --session ID ...) [--out PATH] [--db PATH] [--json]

Inputs and options#

  • --open selects every session this machine touched in the last N hours (default 24); --session selects one exact session and may repeat.
  • --out writes one file instead of standard output; --db overrides the index; --json selects structured output.

Output and state effect#

  • Refreshes each session's ledger from the newer of the indexed copy and the live harness file, then prints per session the file read, the message count, and every operator message with its ordinal and timestamp. Nothing an agent wrote is in the list, and nothing is summarised.
  • --out writes the same text to one path and prints how many messages from how many sessions it holds, which is the request four sessions each answered with a throwaway pipeline.

Refusals and safe exits#

  • Refuses without --open or --session and prints the usage; a session absent from the index refuses with its id and names transcripts reindex as the repair; index open, transcript read or file write failures exit unsuccessfully.

CLI reference#