Jeden/Docs

CLI command

jeden workspace status

Show the currently adopted workspace and the existing sessions associated with it.

Exact invocation#

Shell
jeden workspace status [--json]

Inputs and options#

  • No path is accepted. Optional: --json for the structured operation report.

Output and state effect#

Reads the user selection and inspects the workspace and canonical session root without mutating either. With no selection it prints a setup command or returns {"status":"not_adopted"}.

Refusals and boundaries#

  • A selected path that no longer resolves is refused with its jeden.workspace cause, and a stored value that is not a string as adopted-not-text; a word after status is argument-unexpected.
  • 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: <operation>.<cause>, and jeden errors show <operation> lists every cause of that functionality.