Jeden/Docs

CLI command

jeden context prompt

Print exactly the recommendation block a turn would append for this task.

Exact invocation#

Shell
jeden context prompt "<task>" [--json] [--cwd path]

Inputs and options#

  • The task text. The resolved context.advisor settings apply; per-run source and limit flags belong to recommend.
  • --json returns query, enabled, sources, maxChars and block, where block is null when nothing would be appended.

Output and state effect#

Renders the [Context recommendations] block, within context.advisor.maxChars when it is declared and whole when it is not, including the list of sources that answered nothing. It calls no model and records no session; it is the way to see what the next turn will actually receive.

Refusals and boundaries#

  • The functionality is jeden.context; jeden errors show jeden.context prints every cause with its test (tests/context/command.mjs). Each refusal prints what failed, why and what was observed, then fix: … and cause: jeden.context.&lt;cause&gt;. Read before any source is asked, each exit 2: verb-missing (no word at all), task-missing (&lt;verb&gt; answers for a task, and the command line holds only options), option-unknown (an option the verb does not take; prompt takes neither --limit nor --source), limit-missing, limit-invalid (--limit takes a whole number of recommendations above zero, and `X` is not one), source-missing (--source with no list, or a list of separators only), source-unknown (the context advisor has no source named X, observed: the sources there are) and argument-unexpected (a word after sources).
  • configured-source-unknown, exit 1, when context.advisor.sources names a source the advisor does not have.
  • With the advisor switched off the command succeeds and says why: The context advisor is off: context.advisor.enabled is false.
  • With no source selected it succeeds and says No context source is selected: context.advisor.sources resolved to nothing.
  • 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.