list to see what exists. Use doctor to evaluate whether the current project and shell are usable.
Inventory
* marks a globally active version. ready means the expected executable or entry point exists. incomplete means a semantic-version directory exists but is not usable.
JSON:
Health checks
- storage location and writability;
- operating system and architecture support;
- project configuration and compatibility files;
- required runtime, built-in tool, plugin, and plugin-tool availability;
- bounded
--versionprobes; - installation manifests and executable permissions;
- shim presence and PATH precedence;
- shadowing by common version managers;
- cache entries and offline readiness;
- proxy and certificate configuration.
| Status | Meaning |
|---|---|
pass | The checked condition is ready |
warning | A risk or non-blocking concern was found |
fail | The environment or project cannot be used as expected |
Remediation order
Apply fixes in this order:- storage and permission failures;
- invalid project configuration;
- missing or incomplete runtime requirements;
- missing or incompatible tools and plugin tools;
- missing plugins;
- shims and PATH precedence;
- cache, proxy, and certificate warnings.
jolter doctor after each environmental change.
Probe safety
Doctor can execute already-installed runtimes and tools with--version. Probes:
- never execute a downloaded archive during installation;
- have a five-second timeout;
- capture bounded output;
- set
JOLTER_DOCTOR=1for the child process.