cursor-doctor

IDE extensions Updated Mar 8, 2026

🔄 Updated Mar 2026

Overview

Health scanner and diagnostic tool for Cursor AI IDE configuration (.cursor/rules/ files). Scans for broken YAML frontmatter, rule conflicts, redundancies, missing alwaysApply, token budget issues, and stack coverage gaps. Available as CLI (`npx cursor-doctor scan`) and VS Code extension.

Problem It Solves

Detects configuration issues in Cursor AI IDE rules files, ensuring optimal performance and correctness.

Target Audience: Developers using Cursor AI IDE, particularly those managing complex rule configurations.

Inputs

• .cursor/rules/ files

Outputs

• Diagnostic reports
• Suggested fixes

Example Workflow

1 Scan .cursor/rules/ directory
2 Validate YAML structure
3 Check for rule conflicts
4 Identify redundancies
5 Detect missing alwaysApply flags
6 Analyze token budget usage
7 Evaluate stack coverage
8 Generate diagnostic report

Sample System Prompt


              npx cursor-doctor scan --path ./my-project/.cursor/rules/

Tools & Technologies

Node.js YAML parser VS Code

Alternatives

• Manual review
• Custom scripts

FAQs

Is this agent open-source?: True
Can this agent be self-hosted?: True
What skill level is required?: intermediate

Rate This Agent

Your rating:

Reviews

Loading reviews...