Command reference
oko context snapshot
Reads the masked transcript catalogue from the shared Oko database and the named company/Slack caches through oko, without a Python bridge or model call.
Invocation#
oko context snapshot --limit N [--query TEXT] [--strategy PATH] [--slack PATH]Inputs and options#
- --limit N, required: how many documents each source answers (a positive whole number; there is no default). Optional query (searched in the shared catalogue; without one the newest sessions are read), company strategy path and Slack JSONL cache path.
- Over the native API the same read is action snapshot with a required limit. The Slack responder reads it as its native_context tool, stating the limit it needs; nothing is prefetched for a reply.
Output and state effect#
- Prints source state, operation, location, observation time, document count and actual errors together with retrieved documents. Cached content is not represented as a fresh provider read.
- The catalogue is the signed-in person's rows in the shared Oko database that Stado resolves; nothing is written.
Refusals and safe exits#
- “oko context snapshot requires --limit <whole number>” and “oko context snapshot: --limit takes a positive whole number, got <text>”. An unreadable catalogue (no Wisent session, the database refusing, or oko missing) exits nonzero with the source report naming the error. Missing optional caches are notConfigured. Invalid cache data is unavailable, not an empty success. Unknown options fail; --db no longer exists because there is no local catalogue to point at.