Jeden/Docs

CLI command

jeden todo pause

Pause retained work without losing it.

Exact invocation#

Shell
jeden todo pause <task-or-request-id> --revision <n> --reason "text" [--session <id-or-path>] [--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#

Marks the selected unfinished work paused. It remains incomplete and the execution agent cannot resume it itself. Telling the session to stop, or not to code for now, does the same: the intake pauses every open task the order covers, keeps your words as the task's reason, and the turn ends with Work remains paused instead of starting another one. A pause you give here is lifted only here or in the graphical Tasks panel.

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).
  • 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.