Home

devin-doctor

Diagnoses a Devin Desktop/CLI installation: one command checks stores, schema versions, config files, locks and disk, then prints a health report with concrete fixes. Read-only, always.

Why it exists

Every other tool in the ecosystem reads the same local stores. When something looks wrong, doctor is the first thing to run — it answers "is my Devin install healthy?" before you blame a tool.

Install

pipx install devin-doctor
# or: pip install devin-doctor  (PyPI)

Requires Python 3.10+ unless noted. Linux, Personal Windows and Corporate Windows are supported; see the repo's platform READMEs for differences.

Core commands

Command	What it does
devin-doctor check	run all health checks and print the report
devin-doctor report	structured output of the same checks
devin-doctor plan	ordered fix plan for failures found
devin-doctor capabilities	what this install supports

What it touches

Reads: sessions.db, state.vscdb, acp-messages/, .devin/ config, disk stats. Writes: nothing. Pure diagnostics.

Limitations

• Detects problems; plan suggests fixes but never mutates stores.
• Schema detection is best-effort across Devin versions.

---

Unofficial community project. Not affiliated with Cognition AI. Part of the devin-* ecosystem.