Would a local read-only vault health report be useful for Obsidian users?
Hi everyone. I noticed a problem in my own Obsidian vault: notes accumulate, Inbox items stay unprocessed, links break, attachments become clutter, and tasks get scattered across old files.
Before releasing a scanner, I want to validate whether this report format is useful. I prepared a small demo vault and a sample report to show the intended output.
The idea is a read-only vault health report.
Not a cleaner. Not an AI agent. Not a cloud service. Just a local report that shows what might need attention.
Important context:
- this is a sample report for validation, not a public scanner release
- the scanner is intended to be local-first and read-only
- no cloud upload
- no AI analysis in v0
- no auto-edits
- the tool should not modify notes automatically
GitHub repo:
https://github.com/hrist94/vault-doctor
Sample report:
https://github.com/hrist94/vault-doctor/blob/main/demo-vault/vault-health-report.md
Short summary:
https://github.com/hrist94/vault-doctor/blob/main/demo-vault/Sample%20Report%20Summary.md
I’d appreciate blunt feedback on the demo vault and sample report.
Questions:
- Does this problem feel real in your own vault?
- Which section of the sample report is most useful?
- Which section feels unnecessary or noisy?
- Would you run a local read-only scanner to get this report?
- Would you prefer this as a CLI, Obsidian plugin, or desktop app?