orm-doctor
v1.0.2
Published
Static analysis CLI for detecting ORM/database bottlenecks in TypeScript and Prisma/Drizzle codebases.
Maintainers
Readme
orm-doctor
Static analysis CLI for ORM and database bottlenecks in TypeScript and Prisma/Drizzle codebases.
Built by NoctisNova.
Install & run
No install required:
npx orm-doctor
npx orm-doctor ./my-app
npx orm-doctor --json
npx orm-doctor --no-aiGlobal install (optional):
npm install -g orm-doctor
orm-doctorWhat it detects
- N+1 queries — DB calls inside loops
- Missing indexes — foreign keys without
@@indexin Prisma schema - Unsafe raw SQL —
$queryRawUnsafe/ dynamic raw queries - Mass mutations —
updateMany/deleteManywithoutwhere - Unbounded queries —
findMany()withouttakeor cursor - Prisma singleton — multiple
new PrismaClient()instances - Missing transactions — multiple writes without
$transaction - Risky relations — missing
onDeletereferential actions - Seed issues — slow seeds, hardcoded IDs, missing truncate
Produces a scored health report (0–100) and saves .orm-doctor-report.json for AI-assisted fixes.
Requirements
- Node.js 18+
Links
- Homepage: https://noctisnova.com
- Repository: https://github.com/NoctisNovaStudio/orm-doctor
- Issues: https://github.com/NoctisNovaStudio/orm-doctor/issues
License
MIT
