Question 1

How do I set up clj-kondo for my Clojure project?

Accepted Answer

Start by creating a .clj-kondo directory, then run clj-kondo with your build tool's classpath using --dependencies and --copy-configs to import library configs. This populates the cache for accurate cross-namespace linting, as detailed in the README's project setup section.

Question 2

clj-kondo vs eastwood: which should I use?

Accepted Answer

Clj-kondo is faster and editor-agnostic due to static analysis without a runtime, ideal for quick feedback. Eastwood runs on the JVM and can execute macros, but is slower. Choose clj-kondo for speed and integration, eastwood if you need deep macro expansion analysis.

Question 3

Does clj-kondo work with ClojureScript?

Accepted Answer

Yes, it fully supports ClojureScript (.cljs files) alongside Clojure and EDN. It detects issues like arity errors in Cljs.core functions by caching dependencies, making it useful for full-stack Clojure projects.

Question 4

How can I configure clj-kondo for custom macros?

Accepted Answer

Use the config file to define hooks or import community configs from the clj-kondo/configs repository. For unrecognized macros, you may need to write Clojure code in hooks to simulate their behavior, as explained in the macros section.

Question 5

What are the most common warnings clj-kondo gives?

Accepted Answer

Frequent warnings include unused vars, arity mismatches, unresolved symbols, and style violations like long lines or redundant do wrappings. The README lists all linters, with examples for common cases like inline def expressions.

Question 6

Can I use clj-kondo in continuous integration?

Accepted Answer

Absolutely, it integrates well with CI pipelines via command-line options like --fail-level to control exit codes. The README provides a CI integration guide, making it easy to enforce code quality checks automatically.

clj-kondo

What is clj-kondo?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions