Jeden/Docs

CLI command

jeden workspace adopt

Persist an existing local repository as the default workspace used by the next Jeden task.

Exact invocation#

Shell
jeden workspace adopt <path> [--json]

Inputs and options#

  • Required: one existing readable directory path. Optional: --json.

Output and state effect#

Runs the discover validation and only then atomically writes the canonical path to the user configuration. Re-adopting the same canonical path is idempotent and reports one unchanged result without rewriting; matching session ledgers remain where Jeden originally recorded them.

Refusals and boundaries#

  • Every cause of jeden.workspace listed on the workspace page is refused before the user configuration changes; a write that fails is a cause of jeden.config.write and never claims adoption.
  • 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.