Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

lein-try Build Status

A Leiningen plugin for trying out Clojure libraries in a REPL without creating a project or adding them to an existing project.

Special thanks to contributors @xsc and @seancorfield for making lein-try amazing.


Leiningen (via Clojars)

Put the following into the :plugins vector of the :user profile in your ~/.lein/profiles.clj:

;; All alone:
[lein-try "0.4.3"]

;; The whole thing:
{:user {:plugins [[lein-try "0.4.3"]]}}

This plugin requires Leiningen >= 2.1.3.

Command Line

You can use lein-try to open a REPL with any dependencies you specify loaded and ready to use.

$ lein try clj-time "0.5.1"
Fetching dependencies... (takes a while the first time)
lein-try loaded [clj-time "0.5.1"]

nREPL server started on port 57036
REPL-y 0.2.0
Clojure 1.5.1
    Docs: (doc function-name-here)
          (find-doc "part-of-name-here")
  Source: (source function-name-here)
 Javadoc: (javadoc java-object-or-class-here)
    Exit: Control+D or (exit) or (quit)


You can even leave off the version number and leiningen will pull the most recently released version! (Thanks @xsc.) The command lein try clj-time evaluates as lein try clj-time "RELEASE". Feel free to mix versioned and unversioned dependencies–we're good like that.

$ lein try clj-time

To see available options, call lein help try:

$ lein help try
Launch REPL with specified dependencies available.


    lein try io.rkn/conformity "0.2.1" com.datomic/datomic-free "0.8.4020.26"
    lein try io.rkn/conformity 0.2.1
    lein try io.rkn/conformity # This uses the most recent version

Arguments: ([& args])

In Emacs

Miss Emacs integration while lein trying? In your *scratch* buffer, set your inferior-lisp-program var...

(setq inferior-lisp-program "lein try tentacles")

and then launch M-x inferior-lisp.


Contributions are more than welcome. Fire away in an issue or pull-request.


Copyright © 2013 Ryan Neufeld

Distributed under the Eclipse Public License, the same as Clojure.