CLI command
jeden workspace adopt
Persist an existing local repository as the default workspace used by the next Jeden task.
Exact invocation#
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.workspacelisted on the workspace page is refused before the user configuration changes; a write that fails is a cause ofjeden.config.writeand 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) exits69; any other refusal or failure exits1. A refusal a functionality declares ends withfix: …andcause: <operation>.<cause>, andjeden errors show <operation>lists every cause of that functionality.