cursor-doctor is a powerful linter and auto-fixer designed for managing Cursor rules effectively. With its ability to identify issues such as conflicting directives, broken globs, and vague instructions, this tool ensures that Cursor applies rules as intended. Emphasizing the notion that rules should be treated like code rather than mere configuration, cursor-doctor performs over 100 checks without any dependencies.

Key Features:

• Robust Diagnostic Checks: Detects a wide range of issues across various categories, including:
  • Syntax Errors: Identifies broken YAML, missing frontmatter, boolean strings, and unclosed code blocks.
  • Conflicts: Highlights contradictory instructions across files through 48 semantic patterns.
  • Token Budget Issues: Recognizes rules that diminish context window space, dead rules, and excessive application parameters.
  • Glob Patterns: Analyzes globs for non-matching patterns and improper regex use.
  • Prompt Quality Assessments: Checks for vague rules, improper phrasing, and redundancy within instructions.
  • Structural Problems: Flags issues like file naming conventions, duplicate content, and absent descriptions.

Usage:

Easily scan for errors by executing:

npx cursor-doctor scan

No installation is necessary, as it can be run directly using npx.

Auto-Fix Functionality:

With the Pro version, cursor-doctor can automatically fix various issues such as frontmatter errors, glob syntax inconsistencies, and more:

npx cursor-doctor fix --preview  # Preview changes
npx cursor-doctor fix              # Apply all fixes

A one-time purchase provides the Pro key for additional features.

Integration Options:

• VS Code/Cursor Extension: Offers inline diagnostics and quick-fix actions. Available in the VS Code Marketplace.
• CI Integration: Easily add cursor-doctor to workflows to catch rule errors before merging changes.

- uses: nedcodes-ok/cursor-doctor@v1

• LSP Server Support: Enables real-time diagnostics in any LSP-compatible editor.

Related Projects:

• rule-gen: AI-powered rules generation for your codebase.
• rule-porter: Convert rules seamlessly across different platforms.
• Explore more tools and guides at nedcodes.dev for Cursor AI developers.