| name | doctor |
| description | Run a health check on the bundled Lumen semantic search setup for the current project, verify backend reachability and index freshness, and summarize remediation steps. |
Lumen Doctor
Run a health check on the bundled Lumen semantic search setup for the current
project.
Steps
- Call the Lumen
health_check tool to verify the embedding service is
reachable.
- Call the Lumen
index_status tool with path or cwd set 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
- Any MCP or plugin setup issue that blocks the tools
- If no index exists yet, explain that the Lumen
semantic_search tool 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.