Linter and formatter config: instant feedback for AI coding agents
This check looks for a committed linter or formatter config: ESLint, Prettier, Biome, Ruff, rustfmt, Clippy, golangci-lint, RuboCop, clang-format and about twenty others.
How many repos commit a linter or formatter config?
Of the 401 repos on the leaderboard, 262 pass in full (65%), 0 pass in part (0%) and 139 fail (35%).
Why do AI coding agents need a linter config?
A linter makes style checkable. The agent runs it, reads the errors and fixes them, instead of copying whatever the nearest file does. Aider lints after every edit by default, so without a config it has nothing to lint against.
What counts as a linter or formatter config?
- Full pass: a config file for a supported tool, or a
[tool.ruff],[tool.black],[tool.flake8],[tool.pylint]or[tool.mypy]section inpyproject.toml. - Fail: no config found. We do not run the linter.
How checks become a score: methodology.
How do I add a linter config to my repo?
Commit the config for your language's standard tool and put the lint command in AGENTS.md. A linter run on default settings leaves no file to find.
Which AI coding agents weigh a linter config most?
- Aider14% of its score
- Pi11% of its score
- Cursor9% of its score
- Kimi Code CLI8% of its score
- Claude Code8% of its score
- Gemini CLI8% of its score
- Codex8% of its score
- OpenHands6% of its score
- Devin6% of its score
Pass rate by language
- Elixir7 of 7 (100%)
- Clojure5 of 5 (100%)
- Ruby9 of 10 (90%)
- Python50 of 56 (89%)
- JavaScript13 of 15 (87%)
- Dart6 of 7 (86%)
- Scala5 of 6 (83%)
- C++17 of 21 (81%)
- Rust36 of 45 (80%)
- PHP9 of 12 (75%)
- Go28 of 40 (70%)
- C7 of 10 (70%)
- Swift7 of 10 (70%)
- TypeScript47 of 82 (57%)
- C#2 of 8 (25%)
- Java6 of 28 (21%)
- Zig1 of 6 (17%)
- Kotlin1 of 12 (8%)
- Haskell0 of 7 (0%)
Top-scoring repos that pass
- Rust · 6.8k ★
- Ruby · 48.1k ★
- pingcap/tidb89.6Go · 40.7k ★
- gitlab-org/cli88.8Go · 1.1k ★
- apache/superset88.7Python · 75.4k ★
- axios/axios88.1JavaScript · 109.3k ★
- aio-libs/aiohttp88.1Python · 16.6k ★
- PostHog/posthog88.0Python · 40.7k ★
- C++ · 133.6k ★
- Python · 46.3k ★
- Rust · 33.3k ★
- TypeScript · 115 ★
Popular repos that fail it
- TypeScript · 394.1k ★
- TypeScript · 225.1k ★
- TypeScript · 199.4k ★
- Python · 187.9k ★
- TypeScript · 154.9k ★
- Python · 149.1k ★
- golang/go29.9Go · 139.8k ★
- Go · 128.9k ★
Every check, grouped into what to do first: how to make your repo ready for AI coding agents.