Skip to content

rai doctor

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

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

FlagShortDescription
--verbose-vShow all checks including passing
--jsonJSON output for CI
--fixAuto-fix common issues (creates backups before modifying)
--onlineInclude online checks (MCP, adapter connectivity)
--category-cRun only this check category
Terminal window
# 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.


Generate a diagnostic report, optionally send via email.

FlagShortDescription
--sendOpen email client with report
Terminal window
# Generate report to stdout
rai doctor report
# Open email client with report
rai doctor report --send

See also: rai gate check