CLI Reference
memories doctor
Check memories health and diagnose issues.
memories doctor [options]Run diagnostic checks on your memories database and optionally fix issues.
Options
| Option | Description |
|---|---|
--fix | Attempt to fix issues found |
Checks Performed
- Database file — Verifies the database file exists at the expected path
- Connection — Tests that the database can be opened and queried
- Schema integrity — Runs
PRAGMA integrity_checkto verify data consistency - FTS index — Checks the full-text search index is operational and that no soft-deleted records have leaked into the FTS index
- Git detection — Verifies project detection is working in the current directory
- Orphaned memories — Checks for project-scoped memories with no matching project
- Soft-deleted records — Reports the count of soft-deleted records
Fix Mode
When --fix is passed, the doctor will:
- Permanently purge (hard-delete) all soft-deleted records
- Rebuild the FTS5 full-text search index
memories doctor --fixExamples
Run diagnostics:
memories doctorDiagnose and fix:
memories doctor --fix