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>|defect <id>|answer <id> --text "answer"|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, each request's time-to-completion estimate and verified completion time, task states, independent observations, actual failures and what a blocked task asks of you 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 session in a workspace that recorded none: jeden.session.find.last-session-unrecorded (finding the last session of &lt;cwd&gt; for jeden todo: … no session is recorded for &lt;cwd&gt; yet, fix: name one with --session &lt;id-or-path&gt;), exit 1. A recorded last session that is gone is session-not-found of the same functionality.
  • The command is read whole before any session is opened, jeden.completion.command, exit 2: an option without its value (value-missing), a revision that is no whole number (revision-invalid), an unknown option or action (option-unknown, verb-unknown), words an action does not take, such as jeden todo list extra (words-invalid), and a control without --reason (--text for answer) and --revision (control-incomplete, naming what is left out).
  • A stale revision is jeden.completion.state.revision-changed, naming the revision the change was asked of and the one the state is at, with the jeden todo list to read it again; nothing is changed.
  • A control is jeden.completion.control: an unknown ID is id-unknown, naming the session's requests and tasks; completed or cancelled work is terminal (request-terminal, task-terminal with its state) and cannot be resumed by changing its status; a task of a paused request is owner-paused until the request is resumed; a blank reason is reason-blank (exit 2).
  • There is no operator done command: jeden todo done is jeden.completion.command.verb-unknown, saying that task completion requires independent verification, so there is no operator done action.
  • A command line of the wrong form (an unknown command or option, a missing, unexpected or invalid argument, a missing confirmation) prints the error and the usage and exits 2; a refusal that retrying unchanged can help (a dependency down or not answering, a rate limit) exits 69; any other refusal or failure exits 1. A refusal a functionality declares ends with fix: … and cause: &lt;operation&gt;.&lt;cause&gt;, and jeden errors show &lt;operation&gt; lists every cause of that functionality.