jeden workspace

Exact invocation#

jeden workspace [status|discover [path]|adopt <path>] [--json]

Inputs and options#

• No action defaults to status. discover accepts an optional existing path and otherwise inspects the current directory. adopt requires a path.
• A relative path is resolved from the invocation directory; --json returns the same operation report as a JSON object.
• The supported sources are an existing readable directory and a Git working tree detected by an existing .git directory or worktree file in that path or an ancestor. Jeden session history is associated through each canonical state.json cwd; it is not re-imported.

Output and state effect#

discover validates without writing. adopt validates the complete source first, then atomically stores its canonical absolute path as workspace.defaultPath in ~/.jeden/config.yml. A later interactive, run, or pursue task uses that workspace unless --cwd is explicit; adoption from a running terminal first-use or setup screen also rebases that session before its next agent turn. The result names the accepted path, source kind, repository root, existing sessions accepted or unreadable, and imported/unchanged/conflicting/rejected counts. It never copies, cleans, resets, or writes the repository or its session ledgers.

Refusals and boundaries#

• A missing adopt path is refused with Usage: jeden workspace adopt <path> [--json]; an unknown action prints the complete workspace usage.
• A path containing .., a missing or unreadable path, a non-directory, a malformed existing .jeden/config.json, or a user-config write failure is refused before selection changes.
• If a previously adopted path is unavailable, implicit task startup fails and names --cwd as the explicit override instead of silently changing workspace.