Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Health check + repair: daemon, locks, temp, FDA, versions, row counts
duckbrain doctor # detect
duckbrain doctor --fix # detect + auto-repair what's safe
--fix, repairs what it safely can. Run it first whenever anything misbehaves.
| Check | --fix repairs |
|---|---|
| DuckDB version (pinned ≥ 1.5.4) | — |
| Instance + bronze — per-source row counts | — |
| Embed backlog — rows still awaiting vectors | — (sync catches up) |
| Daemon health — is the watch daemon running when sync is on? | restarts it if it died |
| Stale daemon code — is the running daemon older than your source? | restarts it onto current code |
Stale locks — sync.lock/watch.lock held by a dead pid | removes them |
| Orphaned temp — leaked snapshot/staging files | deletes them |
iMessage FDA — is chat.db readable? | — (grant Full Disk Access yourself) |
| Crawler binaries — installed for each available source? | — (brew install …) |
git pull) doesn’t take effect until it restarts — doctor detects that (“running code older than your source”) and --fix restarts it for you.