Cursor Doctor

Diagnose and auto-fix your Cursor AI setup — right in your editor.

Health grade in your status bar. Inline diagnostics on save. One-click quick fixes.

Features

🏥 Health Grade in Status Bar

See your Cursor setup health at a glance — A through F — updated every time you save a rule file. Click it to see the full report.

🔍 Full Scan Report

Run a scan to see every check, what passed, and what needs fixing.

💡 Quick Fix Actions

Click the lightbulb on any issue to fix it instantly — add frontmatter, convert globs, add missing fields. No manual editing needed.

🔍 9 Health Checks

• ✅ Rules exist (.mdc format)
• ✅ No legacy .cursorrules conflicts
• ✅ Rule syntax (frontmatter, globs, structure)
• ✅ Token budget (are your rules eating your context window?)
• ✅ Coverage gaps (file types without rules)
• ✅ File sizes (oversized context files)
• ✅ alwaysApply balance
• ✅ Agent skills detection
• ✅ Plugin validation

📋 Inline Diagnostics

Errors and warnings show directly in your .mdc files — in the Problems panel, with squiggly underlines, on save.

🔧 Auto-Fix (Pro)

One command to fix what the scan finds:

• Repair broken frontmatter
• Merge redundant rules
• Annotate conflicts
• Generate starter rules for your stack (React, Next.js, Python, Go, Rust, Vue, Svelte, and more)

🔄 Migrate

Convert legacy .cursorrules to modern .cursor/rules/*.mdc format.

Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Free vs Pro

Free gives you the health grade, all diagnostics, and migration.

Pro ($9 one-time) unlocks auto-fix and template generation.

👉 Get Pro

Install

• VS Code Marketplace
• OpenVSX (used by Cursor)

Or search "Cursor Doctor" in the extensions panel.

Also Available as CLI

npx cursor-doctor scan

cursor-doctor on npm | GitHub

License

MIT