Command reference
oko-cli transcripts tasks-control
Puts every session that still owes the operator something back to work on exactly that.
Invocation#
oko-cli transcripts tasks control (--open [--hours N] | --session ID ...) [--dry-run] [--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.
- --dry-run prints the handover for each session and starts nothing; --db overrides the index; --json selects structured output.
Output and state effect#
- Resumes each session from its own transcript through Oko's PTY broker, with its open-task list as the prompt: the operator's own sentences with their ordinals, the reason each is still open, and the exact `transcripts tasks evidence` command that records a result. Prints the broker session id and the ordinals handed over.
- A task is handed over while the operator has not closed it; recorded evidence does not remove it, and a withdrawn task is never handed back. A task another session has claimed stays with its leader, so two agents do not edit one checkout.
- The handover arrives in the transcript as a user turn and is recognised as the product's own: it never becomes a task in the report.
Refusals and safe exits#
- Refuses without --open or --session and prints the usage; refuses by name when the PTY broker is not answering (naming `pty broker-ensure`) or the harness binary is absent, so no session is reported resumed when nothing started; a session absent from the index refuses with its id and names transcripts reindex as the repair.