JEDEN Request access
Jeden/Docs

CLI command

jeden todo

Inspect and control every retained user request and its verified task state.

Exact invocation#

Shell
jeden todo [list|add "request"|pause <id>|resume <id>|cancel <id>|continue] [--session <id-or-path>] [--revision <n> --reason "text"] [--json]

Inputs and options#

  • Optional --session &lt;id-or-path&gt; selects a recorded session; otherwise the workspace's latest session is used. --json returns the authoritative completion snapshot.
  • An original request ID controls every unfinished task it owns, including an unplanned request when model intake is unavailable. A task ID controls that task only. --revision must match the latest snapshot and --reason must explain the operator's action.

Output and state effect#

Stores requests, acceptance criteria, task states, independent observations and actual failures in the session's atomic completion.json. The agent's todo done action requests verification; it cannot mark work complete. Starting another question, clearing model context, or resuming a recorded session does not discard retained obligations. Legacy task claims are imported for verification rather than trusted as successful.

Refusals and boundaries#

  • Without a selected or current session: no active session; use --session &lt;id-or-path&gt;.
  • Missing control fields: task control requires --revision or task control requires --reason; an empty explanation is refused as task control requires a nonempty operator reason.
  • A stale revision is refused as completion state changed: expected revision &lt;expected&gt;, found &lt;actual&gt;; refresh the snapshot before choosing another action.
  • Unknown IDs are refused as unknown task or request: &lt;id&gt;. Completed or cancelled work is terminal and cannot be resumed by changing its status.
  • There is no operator done command: Task completion requires independent verification; there is no operator done command.