Lumen Doctor
Run a health check on the bundled Lumen semantic search setup for the current project.
Steps
- Call the Lumen
health_checktool to verify the embedding service is reachable. - Call the Lumen
index_statustool withpathorcwdset to the current working directory to check index freshness. - Report a concise summary:
- Embedding service status, backend, host, and model
- Index totals: files, chunks, last indexed time, stale or fresh
- Storage totals: unique vectors, shared references, deduplication ratio, vector precision, database bytes, and reclaimable bytes
- Any MCP or plugin setup issue that blocks the tools
- If no index exists yet, explain that the Lumen
semantic_searchtool seeds the index on first use. - If the user wants eager indexing instead of waiting for the next search,
suggest running
lumen index .in the repository root. - Interpret storage totals as collection-wide values shared by compatible Git worktrees; file, chunk, freshness, and indexing values are project-local. A high deduplication ratio is expected and is not an index-health problem.