CIDER is the Clojure(Script) Interactive Development Environment that Rocks!
CIDER extends Emacs with support for interactive programming in Clojure. The
features are centered around cider-mode
, an Emacs minor-mode that complements
clojure-mode. While clojure-mode
supports editing Clojure source files,
cider-mode
adds support for interacting with a running Clojure process for
compilation, debugging, definition and documentation lookup, running tests and
so on.
CIDER is the successor to the now deprecated combination of using SLIME + swank-clojure for Clojure development.
If you like the project, please consider supporting its ongoing development.
The instructions that follow are meant to get you from zero to a running CIDER REPL in under 5 minutes. See the official manual for (way) more details.
package.el
is the built-in package manager in Emacs.
CIDER is available on the two major package.el
community
maintained repos -
MELPA Stable
and MELPA.
You can install CIDER with the following command:
M-x package-install
[RET] cider
[RET]
Simply open in Emacs a file belonging to your lein
or boot
project (like
foo.clj
) and type M-x cider-jack-in
. This will start an nREPL
server with all the project dependencies loaded in and CIDER will automatically
connect to it.
Alternatively you can use C-u M-x cider-jack-in
to specify the name
of a lein
or boot
project, without having to visit any file in it.
In Clojure(Script) buffers the command cider-jack-in
is bound to C-c
M-j.
You can go to your project's directory in a terminal and type there (assuming you're using Leiningen that is):
$ lein repl
Or with Boot:
$ boot repl wait
Alternatively you can start nREPL either manually or by the facilities provided by your project's build tool (Gradle, Maven, etc).
After you get your nREPL server running go back to Emacs. Typing there M-x
cider-connect
will allow you to connect to the running nREPL server.
In Clojure(Script) buffers the command cider-connect
is bound to C-c M-c.
CIDER packs a ton of functionality and you really want to be familiar with it, so you can fully empower your workflow. The best way to get acquainted with all available features is to go over the entire CIDER manual.
An extensive changelog is available here.
The direction of the project is being stewarded by the CIDER core team. This group of long-term contributors manage releases, evaluate pull-requests, and does a lot of the groundwork on major new features.
- Bozhidar Batsov (author & head maintainer)
- Artur Malabarba
- Michael Griffiths
- Jeff Valk
- Lars Andersen
In addition, we'd like to extend a special thanks the following retired CIDER core team members. Lovingly known as The Alumni:
- Tim King (original author)
- Phil Hagelberg
- Hugo Duncan
- Steve Purcell
We’re following SemVer (as much as one can be following it when the major version is 0). At this point bumps of the minor (second) version number are considered major releases and always include new features or significant changes to existing features. API compatibility between major releases is not a (big) concern (although we try to break the API rarely and only for a good reason).
The development cycle for the next major release starts immediately after the previous one has been shipped. Bugfix/point releases (if any) address only serious bugs and never contain new features.
The versions of CIDER and cider-nrepl
are always kept in sync. If you're
tracking the master
branch of CIDER, you should also be tracking the master
branch of cider-nrepl
.
CIDER's logo was created by @ndr-qef. You can find the logo in various formats here.
The logo is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.
You can support the development of CIDER, clojure-mode and inf-clojure via Salt, Gratipay and PayPal.
Support us with a monthly donation and help us continue our activities. [Become a backer]
Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]
Copyright © 2012-2017 Tim King, Phil Hagelberg, Bozhidar Batsov, Artur Malabarba and contributors.
Distributed under the GNU General Public License, version 3