Oko
Oko/Docs

Command reference

oko tasks snapshot

Settles one session's open work as `oko tasks --open --session ID --read-only --owed --json` answers it and writes it to `~/Library/Application Support/Oko/open-work/<ID>.json` (OKO_OPEN_WORK moves the directory), so a gate inside a harness hook reads it in milliseconds instead of settling the sessions itself, which takes longer than a harness waits for a hook.

Invocation#

Command
oko tasks snapshot --session ID [--json]

Inputs and options#

  • --session names the one session; --json prints the path as JSON. Tama's core asks for it after each prompt and stop it answers.

Output and state effect#

  • Replaces the session's snapshot whole with `{session, settledFrom, writtenAt, report}`: report is the owed answer, settledFrom the time settling began, so a reader whose last event is later than settledFrom knows the snapshot does not hold it. Prints `open work of <ID> written to <path>`, or `{snapshot: <path>}` with --json.

Refusals and safe exits#

  • `oko tasks snapshot requires --session <text>`, `oko tasks snapshot does not take <flags>; it takes --session, --json` and `oko tasks snapshot takes only flags; it was given <word>, which it would not read` (exit 2); every refusal of the owed reading, and the snapshot's write refusal with its path.

CLI reference#