You are viewing the documentation for the develop branch. The documentation for the release version is here .

Table of Contents

Common Lisp layer

Table of ContentsClose


1. Description

This layer provides support for Common Lisp to Spacemacs.

1.1. Features:

  • Syntax highlighting
  • Auto-completion using company
  • Repl support via SLIME
  • Support for specific lisp navigation styles via common-lisp-mode
  • Support for sbcl backend or any other common-lisp implementation

2. Install

If you have previously installed slime in any other way, it is recommended that you uninstall it before proceeding. You should clean up any config files tied to slime that are left behind as well. Linux users can just purge the slime package if it was a distribution install.

To use this configuration layer, add it to your ~/.spacemacs. You will need to add common-lisp to the existing dotspacemacs-configuration-layers list in this file.

This layer defaults to using sbcl. If you want to use a different implementation of Common Lisp, you can specify it in your ~/.spacemacs

(defun dotspacemacs/user-config ()
  (setq inferior-lisp-program "/path/to/your/lisp"))

3. Structuraly safe editing

This layer adds support for evil-cleverparens which allows to safely edit lisp code by keeping the s-expressions balanced.

By default this mode is not activated. You can turn it on locally on the active buffer with SPC m T s (s for safe).

To turn it on automatically for all common-lisp buffers call the following function in your dotspacemacs/user-config function:


or to enable it for all supported modes:


When enabled the symbol 🆂 should be displayed in the mode-line.

4. Key bindings

4.1. Working with lisp files (barfage, slurpage & more)

Spacemacs comes with a special lisp-state for working with lisp code that supports slurpage, barfage and more tools you'll likely want when working with lisp.

As this state works the same for all files, the documentation is in global In general, use SPC k to interact with the lisp-state.

4.2. Leader

4.2.1. Help

Key binding Description
SPC m h a SLIME apropos
SPC m h d Disassemble symbol at point
SPC m h h Describe symbol at point
SPC m h i Inspect definition
SPC m h H Hyperspec lookup symbol at point
SPC m h p Browse apropos results for a package's exported symbols
SPC m h t Toggle tracing of the function at point
SPC m h T Untrace all functions
SPC m h < Show all known callers
SPC m h > Show all known callees
SPC m h m Show all usages of a macro
SPC m h r Show references to global variable
SPC m h s Show all methods specialized on a class

4.2.2. Evaluation

Key binding Description
SPC m e b Evaluate buffer
SPC m e c Evaluate parent sexp of current form around point
SPC m e C Evaluate current def or set form around point
SPC m e e Evaluate last sexp
SPC m e l Go to end of line and evaluate last sexp
SPC m e f Evaluate top level sexp
SPC m e F Undefine the function at point
SPC m e r Evaluate region
SPC m e s Evaluate symbol around point

4.2.3. REPL

Key binding Description
SPC m s i Start an inferior process
SPC m s e Evaluate last expression in REPL
SPC m s q Quit

4.2.4. Compile

Key binding Description
SPC m c c Compile file
SPC m c C Compile file and load it
SPC m c l Load file
SPC m c n Remove compilation notes
SPC m c f Compile function
SPC m c r Compile region
Key binding Description
SPC m g g Go to definition
SPC m g b Go back
SPC m g n Next note
SPC m g N or ~SPC m g p Previous note

4.2.6. Macroexpansion

Key binding Description
SPC m m a Macroexpand the expression at point completely
SPC m m o Macroexpand the expression at point once

Author: root

Created: 2022-05-24 Tue 11:51