Jeden/Docs

CLI command

jeden todo add

Record a user request without executing it or inventing its acceptance result.

Exact invocation#

Shell
jeden todo add "request" [--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.
  • Required: nonempty request text. When no active session exists, a new durable session is created.

Output and state effect#

Appends an unplanned request and preserves every earlier request. It does not call a model. Desktop and mobile expose Add without running in their Tasks panels. Continue later to record acceptance criteria independently and execute the request.

Refusals and boundaries#

  • Missing text returns the todo usage (jeden.completion.command.words-invalid); blank text in a named session is jeden.completion.command.request-blank (exit 2). Storage failures are the jeden.completion.state causes, never a claim that the request was completed.
  • 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.