Project Commands
brain project doctor
Validates your entire environment and reports a clear status. Run this when something isn't working.
brain project doctorbrain project doctor
Diagnosing workspace status, configurations, and AI service configurations
Checks performed
Repository
- ✓Project initialized (.brain/ exists)
- ✓Repository analyzed (.brain/data.json populated)
- ✓Git available and functional
Configuration
- ✓brain.yaml present and valid
- ✓Config schema valid
LLM / Provider
- ✓Provider correctly set
- ✓API key environment variable present (if provider ≠ none)
- ✓Model name configured
Exports
- ✓Export directory accessible
Status levels
| READY | All required checks passed — fully operational |
| PARTIAL | Some non-critical checks missing (e.g. no LLM configured) |
| NOT READY | Critical setup missing — run brain project init and analyze |