Vault Doctor
unlistedby Nicolas Homble
On-demand check for duplicate conflict files and unexpected bloat in your .obsidian config folder. Report-only, with an extensible policy framework.
Vault Doctor
On-demand health check for your Obsidian config folder (.obsidian/). One button, one dated report. Nothing runs in the background; nothing is ever deleted for you.

Checks
- Config folder duplicates — numbered conflict copies inside
.obsidian/(workspace 2.json,data 3.json), guarded against false positives. - Config folder size — an oversized config folder, broken down per plugin so the culprit is named.
Both are report-only. See policies for what each flags and why.
Use
Run Run diagnosis from the command palette (or the stethoscope ribbon icon). A dated Markdown report is written to your vault root and opened.
Install
- Catalog: Settings → Community plugins → Browse → "Vault Doctor".
- Beta (BRAT): add
nhomble/obsidian-vault-doctor.
Docs
- Policies — what each check flags and why.
- Writing a policy — add your own check.
- Contributing — local dev and PRs.
License
MIT
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.