Jeden/Docs

CLI command

jeden doctor

Probe the live health of Jeden's configured runtime dependencies and local subsystems.

Exact invocation#

Shell
jeden doctor [--json] [--cwd path]

Inputs and options#

  • Optional: --cwd. The command always emits its structured doctor report; --json is accepted for CLI consistency.

Output and state effect#

Runs Brama, Weles, storage, process, sandbox, MCP, extensions, LSP, browser, TUI keymap, task, memory, and collaboration probes, then prints a JSON report with per-probe evidence and latency. The sandbox probe reports whether a task can run at all: the helper found beside the executable, its signature verdict, and its enforcement probe.

Refusals and boundaries#

  • The command exits unsuccessfully when any active probe is unavailable; degraded or inactive evidence remains explicit in the report.
  • A missing, unsigned, or non-enforcing jeden-sandbox-helper makes the sandbox probe unavailable, naming the helper path checked and the executable it was looked up beside, so a host that would fail every jeden run fails the doctor first.
  • Signature verification and the helper enforcement probe each have a 30-second subprocess deadline. A timeout reports health check timed out after 30 seconds; sandbox remains unavailable, together with the failed operation and helper path. It is not an invalid-signature verdict: the verifier did not finish. The sandbox stays unavailable; neither agent execution nor a successful standalone helper probe overrides the missing verification. This deadline does not bound the whole doctor command or its other probes.
  • Storage probe failures and serialization failures are returned as errors instead of a healthy result.