Repository files navigation

CIDER is theClojure(Script)InteractiveDevelopmentEnvironmentthatRocks!

CIDER extends Emacs with support forinteractiveprogramming inClojure. The features are centered aroundcider-mode, an Emacs minor-mode thatcomplementsclojure-mode andclojure-ts-mode. Whileclojure-mode andclojure-ts-mode support editing Clojure source files,cider-mode addssupport for interacting with a running Clojure process for compilation, codecompletion, debugging, definition and documentation lookup, running tests and soon.

Bozhidar (a.k.a. Bug, CIDER's primary author/maintainer) has spent countless hours working onCIDER and thenumerous related projects. That's a lot of work and not all of it is fun!

Please considersupporting financially CIDER's ongoing development.

The instructions that follow are meant to get you from zero to a running CIDERREPL in under 5 minutes. See theonline documentation for (way) moredetails.

The recommended way to install CIDER is viapackage.el - the built-in packagemanager in Emacs.

CIDER is available on all majorpackage.el communitymaintained repos -NonGNU ELPA,MELPA StableandMELPA.

Provided you've enabled one of them in your Emacs setup, you caninstall CIDER with the following command:

M-xpackage-installRETciderRET

Simply open in Emacs a file belonging to yourlein,tools.deps orboot project (likefoo.clj) and typeM-xcider-jack-in. This will start an nREPLserver with all the project dependencies loaded in and CIDER will automaticallyconnect to it.

Alternatively you can useC-u M-xcider-jack-in to specify the path toa Clojure project, without having to visit any file in it.

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 -s wait

Alternatively you can start nREPL either manually or by the facilities providedby your project's build tool (tools.deps, Gradle, Maven, etc).

After you get your nREPL server running go back to Emacs. Typing thereM-xcider-connect will allow you to connect to the running nREPL server.

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 allavailable features is to go over the entireCIDER manual.

If you're into video lessons, you might also check outthisintro to CIDER demo as well.

You'll find all of CIDER's essential commands and their keybindings in itsone-page printablequick reference card.

New CIDER users might benefit from keeping a copy close to their keyboard.

Start with CIDER'sdiscussions board. If it doesn't get the job done consider some of the other availablesupport channels.

An extensive changelog is availablehere.

The direction of the project is being stewarded by the CIDER core team. Thisgroup of long-term contributors manage releases, evaluate pull-requests, anddoes a lot of the groundwork on major new features.

• Bozhidar Batsov (author & head maintainer)
• Vitalie Spinu
• Michael Griffiths
• Lars Andersen

In addition, we'd like to extend a special thanks the following retired CIDERcore team members. Lovingly known as The Alumni:

• Tim King (original author)
• Phil Hagelberg
• Hugo Duncan
• Steve Purcell
• Artur Malabarba
• Jeff Valk

We’re followingSemVer.

You can read more on the subjecthere.

CIDER's logo was created by@tapeinosyne. You can findthe logo in various formatshere.

The logo is licensed under aCreative Commons Attribution-NonCommercial 4.0 International License.

CIDER's homepagehttps://cider.mx is in thegh-pages branch of this repository and is deployedautomatically when changes are made to it.

It's just a singleindex.html file and a bit of Bootstrap 4. Contributions to it are very welcome!

While CIDER is free software and will always be, the project would benefit immensely from some funding.Raising a monthly budget of a couple of thousand dollars would make it possible to pay people to work oncertain complex features, fund other development related stuff (e.g. hardware, conference trips) and so on.Raising a monthly budget of over $5000 would open the possibility of someone working full-time on the projectwhich would speed up the pace of development significantly.

We welcome both individual and corporate sponsors! We also offer a wide array of funding channels to accountfor your preferences (although currentlyOpen Collective is our preferred funding platform).

If you're working in a company that's making significant use of CIDER we'd appreciate it if you suggest to your companyto become a CIDER sponsor.

You can support the development of CIDER,clojure-mode andinf-clojure viaOpen Collective,GitHub Sponsors,Patreon andPayPal.

Become a sponsor and get your logo on our README on Github with a link to yoursite. [Become a sponsor]

CIDER is distributed under the GNU General Public License, version 3.

Copyright © 2012-2025 Bozhidar Batsov, Artur Malabarba, Tim King, Phil Hagelberg andcontributors.