Command reference
oko-cli transcripts tasks-map
Maps every task in every stored ledger — the whole history, not a window — and places each one by who gave it, what it is and where it stands.
Invocation#
oko-cli transcripts tasks map [--session ID ...] [--place open|waiting|blocked|answered|done|withdrawn] [--origin operator|delegated|automation] [--kind task|defect] [--db PATH] [--json] [--full]Inputs and options#
- Without --session the map covers every session whose ledger the sweep has built; --session narrows it and may repeat. --place, --origin and --kind filter the rows listed; the counts always describe the whole. --full prints each task’s whole text; --json prints the map with its counts and entries; --db overrides the index.
Output and state effect#
- Reads the stored operator messages and annotations without opening a transcript, then prints “sessions with a ledger: N; not swept yet: M”, the task and relation totals, and three count lines — by place (open, waiting, blocked, answered, done, withdrawn), by origin (operator, delegated, automation) and by kind (task, defect) — followed by one row per task: `#N task-id place origin kind text`, its reason and its relations. Origin is operator for the operator’s own words; delegated for a subagent’s session and for a session whose first message is an assignment one agent wrote for another (a capitalised brief with diacritics, code spans, an English opening or two hundred characters or more); automation for sessions the index classifies by their first prompt as a gate, classifier or orchestrator. Place is waiting when the task waits on an open original, predecessor or blocker; blocked when the judge recorded a real blocker; answered when evidence is recorded and not yet judged. On 2026-09-17 the whole history (3 970 sessions) took about two minutes. Never writes.
Refusals and safe exits#
- An unknown --place refuses with “<word> is not a place; one of open, waiting, blocked, answered, done, withdrawn”; an unknown --origin with “<word> is not an origin; one of operator, delegated, automation”; an unknown --kind with “<word> is not a kind; task or defect”. Index open failures exit unsuccessfully.