Doctor
Project health analysis — security audit, dependency check, code quality, and more.
@elyracode/doctor runs a suite of static checks against the current project and feeds the report back to the agent. Use it to triage a new repo, sanity-check before a release, or auto‑heal common issues.
Install
elyra install npm:@elyracode/doctor
Commands
| Command | Description |
|---|---|
/doctor |
Run all checks and send the report to the agent for analysis |
/doctor --heal |
Run checks and step through each finding, fixing as it goes |
Tools
| Tool | Description |
|---|---|
project_health_check |
Run health checks. Filter with category: security, dependencies, config, code-debt, code-quality, git, project |
Checks
| Check | What it does |
|---|---|
| Security | Runs npm audit and composer audit for known vulnerabilities |
| Dependencies | Checks for outdated npm packages |
| Configuration | Compares .env with .env.example for missing keys |
| Code debt | Scans for TODO, FIXME, HACK, WORKAROUND |
| Code quality | Flags source files over 500 lines |
| Git | Reports uncommitted changes and untracked files |
| Project | Verifies essential files (.gitignore, README, configs) |
Examples
> Run a health check on this project
> Are there any security vulnerabilities?
> How many TODO comments are in the codebase?
> Check if my .env is missing any keys
Auto‑heal mode
/doctor --heal
The agent steps through each error and warning:
- Security — runs
npm audit fix/composer update - Dependencies — updates outdated packages one by one
- Configuration — fills in missing
.envkeys - Code debt — implements TODOs, resolves FIXMEs, cleans up HACKs
- Code quality — refactors large files into smaller modules
- Project — creates missing essential files
After each fix the agent verifies the change didn’t break anything.
Report format
# Project Health Report
Errors: 1 | Warnings: 3 | Info: 5
## Errors
- [Security] 2 critical/high npm vulnerabilities found
## Warnings
- [Dependencies] 12 outdated npm packages
- [Code Debt] Found 8 debt markers: 5 TODO, 2 FIXME, 1 HACK
- [Code Quality] 3 files over 500 lines
## Info
- [Configuration] All .env.example keys present in .env
- [Git] Working tree clean
- [Project] All essential files present