HN Showcase
Back to browse
GitHub Repository

Cursor rules linter and auto-fixer. Find out why Cursor ignores your rules. 100+ checks, zero dependencies.

9 starsJavaScript

Cursor-doctor – find out why Cursor ignores your rules

by nedcodes·Mar 3, 2026·1 point·1 comment
Visit ProjectView on HN

AI Analysis

●●SolidSolve My ProblemNiche Gem

Fixes a real Cursor friction point—rules silently fail—but only useful if you're already using Cursor.

Strengths
  • •Solves genuine pain: developers writing rules that silently fail with no feedback on why
  • •100+ semantic checks across syntax, glob patterns, token budgets, and rule conflicts
  • •Free core features (scan, lint, init) with optional Pro tier for auto-fix—good value structure
Weaknesses
  • •Tied entirely to Cursor's popularity and rule format; won't transfer if Cursor changes or loses market position
  • •No evidence of adoption or validation that the checks actually improve rule compliance in practice
Target Audience

Cursor IDE users, teams standardizing AI coding assistants

Post Description

I kept writing Cursor rules that the AI silently ignored. After digging into why, I found a pattern: contradicting directives across files, globs that don't match what you think, YAML frontmatter errors that cause Cursor to skip your rule entirely. So, I built a tool.

npx cursor-doctor scan gives you a health grade (A-F) in 2 seconds. npx cursor-doctor lint tells you exactly what's wrong, file by file. There are 100+ checks so far.

Most of the tool is free (scan, lint, init, migrate). I'd love feedback on what else you'd want checked.

Similar Projects