Doctor

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.

ory Updated

File contents

Lumen Doctor

Run a health check on the bundled Lumen semantic search setup for the current project.

Steps

  1. Call the Lumen health_check tool to verify the embedding service is reachable.
  2. Call the Lumen index_status tool with path or cwd set to the current working directory to check index freshness.
  3. 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
  4. If no index exists yet, explain that the Lumen semantic_search tool seeds the index on first use.
  5. If the user wants eager indexing instead of waiting for the next search, suggest running lumen index . in the repository root.
  6. 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.

ory/lumen/tree/main/plugins/lumen/skills/doctor commit 5453ca42c8

Frequently asked questions

npx skillmds@latest add ory/doctor-2