QMD Doctor

Run a comprehensive health check on the qmd configuration for this project. Perform each check below in order and report results as [PASS] , [FAIL] , or [WARN] . At the end, summarize the total number of issues found.

Remediation Reference

For any failure, suggest the appropriate fix:

Failure Fix

qmd binary not found bun install -g @tobilu/qmd

.claude/qmd.json missing Run /qmd:configure

Missing project field Run /qmd:configure

Collection not in qmd index Run /qmd:configure

Collection naming mismatch Run /qmd:configure to rename

Git hook missing/wrong marker Run /qmd:configure and re-enable git hook

Git hook has old --index flag Run /qmd:configure and re-enable git hook

Guard enabled but no guardedDirs Run /qmd:configure

YAML config missing collection Run /qmd:configure

Checks

1. qmd binary

command -v qmd

[PASS] if found (print the path), [FAIL] if not.

2. Config file exists

Check if .claude/qmd.json exists using Read. If it does not exist, report [FAIL] and stop — remaining checks depend on it.

3. Valid JSON

Read .claude/qmd.json . If you can parse it as JSON, [PASS] . If the content is malformed, [FAIL] and stop.

4. Has "project" field

Check the parsed JSON has a non-empty project string. [PASS] or [FAIL] .

5. Default index database

test -f "$HOME/.cache/qmd/index.sqlite" && echo "exists" || echo "missing"

[PASS] if exists, [FAIL] if missing.

6. Global config

test -f "$HOME/.config/qmd/index.yml" && echo "exists" || echo "missing"

[PASS] if exists, [FAIL] if missing.

7-9. Collection checks

For each key in the collections object:

7. Collection in qmd index:

bash ${CLAUDE_PLUGIN_ROOT}/scripts/qmd-list-collections.sh

Check if the collection name appears in the output. [PASS] or [FAIL] .

8. Naming convention: If the project name is set, check that the collection name starts with {project}_ . [PASS] or [WARN] .

9. YAML config entries

If ~/.config/qmd/index.yml exists, check that each collection name appears in it:

grep -F "{collection_name}:" "$HOME/.config/qmd/index.yml"

[PASS] or [FAIL] per collection.

10-11. Git hook checks (only if gitHook is true )

10. Check .git/hooks/post-commit exists. If it does, verify it contains the marker comment # qmd-auto-index:{project} . [PASS] , [WARN] (marker mismatch), or [FAIL] (missing).

11. Check the hook does NOT contain the deprecated --index flag. [PASS] or [WARN] .

12. Guard config (only if guard is true )

Check that guardedDirs is a non-empty array. [PASS] with count, or [WARN] if empty.

Output Format

Print each result on its own line:

[PASS] qmd binary found: /path/to/qmd [PASS] .claude/qmd.json exists [PASS] .claude/qmd.json is valid JSON [PASS] Project name: myproject [FAIL] Default index database missing: ~/.cache/qmd/index.sqlite ...

N issue(s) found.

If all checks pass, end with: All checks passed.