Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
Failed to load latest commit information.
src/leiningen Clean up help strings & add one for random runner
.gitignore first commit> Bumped version to 0.1.1 and included updated koan-engine.
epl-v10.html Added EPL.


lein-koan is a Leiningen plugin for the Clojure Koan Engine.

The plugin makes two tasks available:

lein koan run: watches koan files for changes and presents the user with the most advanced unsolved koan.

lein koan test: checks that all koans fail without answers and pass with answers.


Add the following to your project.clj under :dev-dependencies:

[lein-koan "0.1.1"]

To see the plugin in action, try out the clojure-koans with the following commands:

git clone
cd clojure-koans
lein deps
lein koan run

To run the clojure-koans tests, try

lein koan test

Writing your own koans

Lein-koan makes it easy to add koans to existing libraries.

  • Write some koans using the instructions at the koan-engine wiki page
  • Add lein-koan to your project
  • lein koan run

and you're off!

For information on how to create your own standalone koan project, check out the instructions at the koan-template github page. The README contains everything you need to know to start writing your own koans and serving them to users.


The use and distribution terms for this software are covered by the bEclipse Public License 1.0 ( which can be found in the file epl-v10.html at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license.

Something went wrong with that request. Please try again.