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 5453ca4 1.3 KB 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/skills/doctor commit 5453ca42c8

Frequently asked questions

npx skillmds@latest add ory/doctor