rai doctor

Diagnose RaiSE setup, report problems, and auto-fix common issues. Checks project structure, knowledge graph, adapters, MCP servers, and more.

rai doctor

Run all diagnostic checks. By default shows only failures; use --verbose to show passing checks too.

Flag	Short	Description
--verbose	-v	Show all checks including passing
--json		JSON output for CI
--fix		Auto-fix common issues (creates backups before modifying)
--online		Include online checks (MCP, adapter connectivity)
--category	-c	Run only this check category

# Quick check
rai doctor

# Verbose output
rai doctor --verbose

# Auto-fix common issues
rai doctor --fix

# Include online connectivity checks
rai doctor --online

# JSON for CI pipelines
rai doctor --json

# Check specific category
rai doctor -c graph

Exit codes: 0 all checks pass, 1 any check fails.

---

rai doctor report

Generate a diagnostic report, optionally send via email.

Flag	Short	Description
--send		Open email client with report

# Generate report to stdout
rai doctor report

# Open email client with report
rai doctor report --send

See also: [rai gate check](gate.md/