AI-powered vault health and maintenance engine for Obsidian.
Vault Physician continuously monitors your knowledge base for structural problems - orphaned notes, stale content, tag sprawl, frontmatter inconsistencies, etc and surfaces them in a clean dashboard with one-click fixes. Optionally connect an LLM to get a plain-English diagnosis of your vault's biggest problems.
| Module | What it finds |
|---|---|
| Orphan Detector | Notes with zero backlinks that haven't been touched in a while |
| Decay Scanner | Notes not modified in 180+ days |
| Frontmatter Linter | Missing common keys and type mismatches across your vault |
| Tag Hygiene | Near-duplicate tags (e.g. #ml vs #ML), single-use tags, tag sprawl |
| Module | What it finds |
|---|---|
| Link Suggester | Related notes that aren't linked yet - with a confirm dialog to pick which links to add |
| Duplicate Finder | Notes that are suspiciously similar in content |
Connect OpenAI, Anthropic, or a local Ollama model to generate a plain-English narrative after each scan and identifies patterns across your vault and tells you the single most impactful thing to fix first.
- SVG ring health gauge - 0–100 score with color (green / yellow / red)
- Severity filter pills - show only critical, warning, or info issues
- Collapsible module sections with issue counts
- Fix-all button per module - runs all auto-fixes in one click
- Weekly digest - generates a Markdown note summarising vault health
| Dashboard | AI Analysis |
|---|---|
 |
 |
| Settings | AI Settings |
|---|---|
 |
 |
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Copy them to
<your-vault>/.obsidian/plugins/vault-physician/ - In Obsidian: Settings → Community Plugins → disable Restricted Mode → refresh → enable Vault Physician
- Settings → Vault Physician → Enable semantic features - toggle on
- Run a scan - the search index builds automatically in the background
No API key required. Uses BM25 keyword similarity via MiniSearch.
- Settings → Vault Physician → AI Analysis → Enable AI analysis - toggle on
- Pick a provider:
- OpenAI -
gpt-4o-miniis recommended. Get a key at platform.openai.com - Anthropic -
claude-haiku-4-5-20251001. Get a key at console.anthropic.com - Ollama (local, free) -
brew install ollama && ollama pull llama3.2
- OpenAI -
- Run a scan — the AI Analysis card appears in the dashboard
- Status bar - the
🏥 NNitem shows your current health score. Click it to open the dashboard - Ribbon icon - stethoscope icon opens the dashboard
- Commands (
Cmd+P):Vault Physician: Run full vault scanVault Physician: Open dashboardVault Physician: Generate weekly digestVault Physician: Rebuild search index
- v0.3.0 — LLM-powered fix suggestions (not just diagnosis)
- v0.4.0 — Broken link detection and repair
- v0.5.0 — Community Plugins submission
git clone https://github.com/your-username/vault-physician
cd vault-physician
npm install
npm run dev # watch mode
npm run build # production buildCopy main.js, manifest.json, styles.css to your vault's plugin folder to test.
MIT