dpm doctor

Run a set of health checks on your DPM installation. Use this to diagnose PATH issues, broken tool records, or a misconfigured environment.

CLI usage

Output

Doctor prints a report of each check with a status indicator:

Status indicators

• ✓ means the check passed.
• ✗ means the check failed.
• ⚠ means warning. It works, but something looks off.

What doctor checks

• Platform shows your OS and architecture.
• DPM root checks that ~/.dpm/ exists and is readable.
• PATH checks that required binaries are reachable.
• Metadata integrity checks that install records are not broken.
• Tool accessibility checks if installed tools can run.
• Version consistency warns when versions do not match records.

TUI: Doctor view

Press M to open the main menu, then select Doctor. The view shows the same platform info and check list with colour-coded status indicators:

• Green ✓ means passing.
• Red ✗ means error.
• Yellow ⚠ means warning.

Each check shows its name and a message. The view shows "Running diagnostics…" while checks are in progress. Press ESC to close.

Common issues and fixes

dpm not in PATH

Your shell may not have reloaded PATH yet. Open a new terminal, or reload your shell config file.

Tool not found in PATH

DPM-managed tool links are exposed from ~/.dpm/bin/. If that directory is missing from PATH, tools may not be found. Add it manually:

Version mismatch

This usually means a tool was updated outside of DPM (e.g. via apt upgrade) and the binary version no longer matches DPM's record. Run dpm update <tool> to re-sync the record, or reinstall the tool with DPM.