Cursor rules: .cursor/rules and .cursorrules in open source repos
Cursor rules are instruction files Cursor reads from the repo: a .cursor/rules/ folder of .mdc files, one topic each, or the older single .cursorrules file at the root.
How many repos have Cursor rules?
Of the 401 repos on the leaderboard, 15 pass in full (4%), 3 pass in part (0.7%) and 383 fail (96%).
Why does Cursor need project rules?
Cursor's Rules docs name .cursor/rules/*.mdc and AGENTS.md as its repo instructions. Devin also pulls Cursor rule files into its Knowledge, so the check counts a little for Devin and most for Cursor.
What counts as Cursor rules?
- Full pass: at least one
.mdcfile in.cursor/rules/, in a subfolder of it, or in a.cursor/rules/folder up to three directories down. A plain.mdfile there does not count: Cursor ignores it. - 50%: only the older
.cursorrulesfile. Cursor's current docs no longer mention it. - Fail: neither is present.
How checks become a score: methodology.
How do I add Cursor rules to my repo?
Create .cursor/rules/ with one .mdc file per topic: code organisation, naming and style, how to run tests. Move any .cursorrules content into them.
Which AI agents read Cursor rules?
Pass rate by language
- TypeScript9 of 82 (11%)
- Ruby1 of 10 (10%)
- Python4 of 56 (7%)
- Rust1 of 45 (2%)
- Go0 of 40 (0%)
- Java0 of 28 (0%)
- C++0 of 21 (0%)
- JavaScript0 of 15 (0%)
- Kotlin0 of 12 (0%)
- PHP0 of 12 (0%)
- C0 of 10 (0%)
- Swift0 of 10 (0%)
- C#0 of 8 (0%)
- Dart0 of 7 (0%)
- Elixir0 of 7 (0%)
- Haskell0 of 7 (0%)
- Scala0 of 6 (0%)
- Zig0 of 6 (0%)
- Clojure0 of 5 (0%)
Cursor rules vs AGENTS.md: which to use, and how to keep one source.
Top-scoring repos that pass
- Ruby · 48.1k ★
- apache/superset88.7Python · 75.4k ★
- PostHog/posthog88.0Python · 40.7k ★
- Python · 46.3k ★
- Rust · 33.3k ★
- novuhq/novu84.5TypeScript · 40.3k ★
- mastra-ai/mastra84.4TypeScript · 29.4k ★
- Shopify/cli81.2TypeScript · 772 ★
- Python · 156.4k ★
- simstudioai/sim76.4TypeScript · 30.1k ★
- hsnice16/tula75.3TypeScript · 0 ★(by this site's author)
- TypeScript · 2.1k ★
Popular repos that fail it
- TypeScript · 394.1k ★
- react/react64.1JavaScript · 252.3k ★
- TypeScript · 225.1k ★
- n8n-io/n8n83.6TypeScript · 209.7k ★
- TypeScript · 199.4k ★
- microsoft/vscode72.0TypeScript · 195.1k ★
- Python · 187.9k ★
- ollama/ollama76.7Go · 186.2k ★
Every check, grouped into what to do first: how to make your repo ready for AI coding agents.