clj-kondo/clj-kondo
GitHubStatic analyzer and linter for Clojure code that sparks joy
- clojure
- clojurescript
- graalvm
- graalvm-native-image
- linter
- static-analysis
- Stars:
- 1.9k
- Language:
- Clojure
- Default branch:
- master
- Last scored:
At a glance
- Rank
- #244 of 401
- #4 of 5 Clojure repos
- Checks passed
- 7 of 17
- Full list below
- Best set up for
- Claude Code
- Score 68.8
- Needs most work for
- Cursor
- Biggest fix: Cursor rules (.cursor/rules) (+11.5 pts)
What it has
What it's missing
What to fix first
Showing fixes for Claude Code
- 1AGENTS.md / CLAUDE.mdAdd an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).+13.2 pts
- 2Type configurationAdd a type config (tsconfig.json for JS/TS, mypy.ini or pyrightconfig.json for Python). Rust/Go/JVM/Scala/Swift/C#/OCaml/Haskell/Zig are typed by default.+7.9 pts
- 3Pre-commit / git hooksSet up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.+5.3 pts
Score for each AI agent
Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →
Does clj-kondo/clj-kondo have agent instructions?
An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.
- AGENTS.md / CLAUDE.md
- None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)
- Agent-specific files
- None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills
- Repos that have one
- 3 of 5 Clojure repos · 222 of 401 repos on the leaderboard · See examples →
Get a starter AGENTS.md
From the files the checks found. Fill in the commands, then commit it at the root.
# AGENTS.md
Guidance for AI coding agents working in clj-kondo/clj-kondo. Static analyzer and linter for Clojure code that sparks joy. Written mainly in Clojure.
## Where things are
- Dependencies are declared in `deps.edn`.
- Tests live in `test`.
- Lint and format rules are configured in `.clj-kondo/config.edn`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- A reproducible environment is defined in `Dockerfile`.
- Follow the conventions in `CONTRIBUTING.md`.
## Commands
<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO
All 17 checks · 7 passed
How clj-kondo/clj-kondo compares
- vs leaderboard average
- 2.4 pts below
- Average 66.9
- vs Clojure average
- 6.5 pts below
- Average 71.0
- Stars among Clojure repos
- #5 of 5
Missing here, and how many repos have it
- Type configuration · passed by 68% of leaderboard repos, 20% of Clojure repos
- Pre-commit / git hooks · passed by 29% of leaderboard repos, 20% of Clojure repos
- Skills (.agents/skills) · passed by 18% of leaderboard repos, 40% of Clojure repos
One fix for the most agents: AGENTS.md / CLAUDE.md would raise the score for all 9 agents, by up to 13.3 points.
Similar repos
Same language and host first, then the repos closest in overall score.
- Clojure · 50.2k ★
- logseq/logseq75.7Clojure · 45.5k ★
- nikic/PHP-Parser64.5PHP · 17.5k ★
- Clojure · 4.6k ★
- fastapi/fastapi64.4Python · 104.5k ★
- penpot/penpot64.4Clojure · 62.2k ★
Same topics, any language
Repos tagged with the same GitHub topics, most shared first.
- astral-sh/ruff86.3Rust · linter, static analysis
- detekt/detekt70.9Kotlin · linter, static analysis
- Haskell · linter, static analysis
- Haskell · linter, static analysis
- Kotlin · graalvm
- oxc-project/oxc81.3Rust · linter
Add a badge to your README
Paste this at the top of the README. It shows the score, and links back to this page.
[](https://agentfriendlycode.com/repo/github/clj-kondo/clj-kondo)Check the score on every pull request
A GitHub Action posts one comment per pull request with how the score changed and why.