hoard doctor

The hoard doctor command runs diagnostic checks on your Hoard installation.

Usage

hoard doctor [options]

Options

Option	Description
`--config <path>`	Use alternate config file

Example Output

$ hoard doctor

Checking Hoard installation...

✓ Python 3.11.4
✓ Config exists: ~/.hoard/config.yaml
✓ Database exists: ~/.hoard/hoard.db
✓ 607 entities indexed
✓ 2,145 chunks created
✓ FTS tables present
✓ Inbox configured: ~/.hoard/inbox

[!] Vectors disabled (run 'hoard init --vectors' to enable)
[!] Watcher enabled but watchdog not installed
[!] No MCP token configured for Claude Code

Checks Performed

Installation Checks

Check	Description
Python version	Requires 3.11+
`hoard` on PATH	Whether the CLI is accessible
Config file	`~/.hoard/config.yaml` exists
Database	`~/.hoard/hoard.db` exists
FTS tables	Full-text search tables present

Data Checks

Check	Description
Entity count	Number of indexed (non-tombstoned) entities
Chunk count	Number of text chunks
Embedding model	Whether embedding model loads (if vectors enabled)

Configuration Checks

Check	Description
Vectors status	Enabled or disabled
Token configuration	Whether MCP tokens are configured
Inbox configuration	Inbox enabled and path exists
Watcher dependency	Warn if watcher enabled but watchdog missing

Common Issues

Missing Config File

[✗] Config not found: ~/.hoard/config.yaml

Fix: Run hoard init to create configuration.

Empty Database

[!] 0 entities indexed

Fix: Add sources and sync:

hoard add ~/Documents/Notes
hoard sync

FTS Tables Missing

✗ FTS tables present

Fix: Delete the database and re-sync:

rm ~/.hoard/hoard.db
hoard sync

Vectors Disabled

[!] Vectors disabled (run 'hoard init --vectors' to enable)

Fix: Enable vectors if you want semantic search:

hoard init --vectors

No Tokens

[✗] No tokens configured

Fix: Create a token:

hoard tokens add default

Exit Codes

Code	Meaning
0	Checks completed