Verify your install (durante doctor)
Run durante doctor to validate your DOS installation and fix common problems.
One command sweeps the install, the license, the prerequisites, the skills, and the version. Each check prints pass, warn, or fail.
What each section checks
Installation — ~/.claude/, settings.json, skills/, and DOS/ must exist. These four are non-negotiable.
License — loads ~/.claude/dos-license.json and checks its status. Missing or inactive shows as a warning, not a failure. DOS degrades gracefully in offline or unlicensed mode.
Prerequisites — verifies git, bun, and claude are on your PATH. Missing any of these is a warning with an install URL attached.
Skills — walks ~/.claude/skills/, counts skills, workflows, and agent contexts, then verifies every skill directory has a SKILL.md. A skill without a manifest cannot be invoked.
Version — reads dos.version from settings.json. null or unknown means the install did not finish stamping the version.
Reading the summary
The last line totals the checks:
- passed — green, nothing to do
- warnings — non-critical; DOS still works
- failed — broken; needs a fix
On any failure, the doctor prints Run durante install to fix installation issues. Re-running the installer over a broken install safely replaces missing pieces and backs up ~/.claude/ to a timestamped directory first.
Common failures and fixes
| Check | Fix |
|---|---|
~/.claude/ exists: ✗ | Run durante install |
settings.json exists: ✗ | Install script was interrupted — re-run durante install |
License file exists: ✗ | Run durante install --key DOS-XXXX-XXXX-XXXX or durante configure |
Bun installed: ✗ | curl -fsSL https://bun.sh/install | bash, restart shell, re-run doctor |
Claude Code installed: ✗ | Install from claude.ai/download |
All skills have SKILL.md: ✗ | Run durante upgrade for a clean copy |
Version detected: unknown | Re-run durante install or durante upgrade — both call writeInstalledVersion() as their last step |
Most common failure: Version detected: unknown
This means the installer copied the files but never stamped dos.version into settings.json. durante status will then keep claiming an update is available forever. Fix it by re-running durante upgrade — the self-update flow writes the version as its final step.
Safe to run anytime
durante doctor is read-only — it never modifies your install. Run it whenever something feels off.
Next
If the doctor is green, head to upgrading DOS to stay current.
Was this page helpful?