nrepl.el

An Emacs client for nREPL, the Clojure networked REPL server.

Installation

If you're not already using Marmalade, add this to your ~/.emacs.d/init.el and load it with M-x eval-buffer.

(require 'package)
(add-to-list 'package-archives
             '("marmalade" . "http://marmalade-repo.org/packages/"))
(package-initialize)

And then you can install:

M-x package-install [RET] nrepl [RET]

(when (not (package-installed-p 'nrepl))
  (package-install 'nrepl))

On Emacs 23 you will need to get package.el yourself or install manually by placing nrepl.el on your load-path and requireing it.

M-x nrepl-jack-in: Launch an nrepl server and a repl client. Prompts for a project root if given a prefix argument.
M-x nrepl: Connect to an already-running nrepl server.

C-x C-e: Evalulate the form preceding point and display the result in the echo area. If invoked with a prefix argument, insert the result into the current buffer.
C-M-x: Evaluate the top level form under point and display the result in the echo area. If invoked with a prefix argument, insert the result into the current buffer.
C-c C-r: Evaluate the region and display the result in the echo area.
C-c C-b: Interrupt any pending evaluations.
C-c C-m: Invoke macroexpand-1 on the form preceding point and display result in a macroexpansion buffer. If invoked with a prefix argument, pprint the result.
C-c M-m: Invoke clojure.walk/macroexpand-all on the form preceding point and display result in a macroexpansion buffer. If invoked with a prefix argument, pprint the result.
C-c M-n: Switch the namespace of the repl buffer to the namespace of the current buffer.
C-c C-z: Select the repl buffer.
C-c C-k: Load the current buffer.
C-c C-l: Load a file.
C-c C-d: Display doc string for the symbol at point. If invoked with a prefix argument, or no symbol is found at point, prompt for a symbol
M-.: Jump to the definition of a var. If invoked with a prefix argument, or no symbol is found at point, prompt for a var.
M-,: Return to your pre-jump location.

RET: Evaluate the current input in Clojure if it is complete. If incomplete, open a new line and indent. If invoked with a prefix argument is given then the input is evaluated without checking for completeness.
C-RET: Close any unmatched parenthesis and then evaluate the current input in Clojure. Also bound to M-RET.
C-j: Open a new line and indent.
C-c M-o: Clear the entire REPL buffer, leaving only a prompt.
C-c C-o: Remove the output of the previous evaluation from the REPL buffer.
C-c C-b: Interrupt any pending evaluations.