This package integrates the excellent lispy lisp editing package to Evil. Lispy works with different lisp modes, like Emacs Lisp and Clojure (and others!).

The goal is to encourage a workflow where you use the standard evil-mode for general editing, and enter evil-lispy-mode to make structural edits using lispy bindings.

Here is a sales pitch of what this mode thinks is best for you:

• Lisp has a natural structure
  • Natural to edit structurally
  • Natural to navigate structurally
• You will want to use structural editing when possible, and fallback to familiar Evil commands.
  • With evil-lispy, use hjkl for moving, C-SPC (control+space) to select, e to eval. Intuitive for Evil / vim users. You now know the basics!
• Natural and easy fallback to vanilla Evil editing
  • If you panic, just hit ESC to return to normal mode
  • You can still use e.g. Evil () text objects just fine. When you learn more of lispy, your productivity will only increase.
• Modal editing is good for your health
  • Lispy commands only apply when explicitly activated
  • Less chance of munging your code unexpectedly

Lispy has great power, and while it comes at the cost of a lot of key bindings, you can get started with just a few. To this end, evil-lispy provides cheat sheets, such as this one for navigation commands:

You can access these with f1 while in evil-lispy-state. Read on for more information.

Available from MELPA.

;; M-x package-install evil-lispy
;; in your config, load the code with e.g. require
(require 'evil-lispy)
;; make evil-lispy start in the modes you want
(add-hook 'emacs-lisp-mode-hook #'evil-lispy-mode)
(add-hook 'clojure-mode-hook #'evil-lispy-mode)

To learn lispy, I suggest you see these things in order:

• first read the lispy introduction to get an overview of what lispy offers to you
• delve into the lispy function reference to get new ideas and learn new things

All lispy structural editing commands are available when evil-lispy-mode is activated. So to use these commands, you must first enter evil-lispy-mode.

Enter evil-lispy-mode mode from normal mode with the following commands:

Other special functionality only available in normal mode:

You can select anything in evil-visual-mode and use these commands:

Reminder: In standard insert-mode, you can write any characters normally. Only when you explicitly activate evil-lispy-mode, lispy commands become available.

These special bindings are active in insert mode:

These bindings are different from vanilla lispy:

In lispy, using C-u 2j will go down two sexps. To get the same thing in evil-lispy, you can use 2j, just like in evil/vim.

Forked from bcarrell/evil-lispy. Many, many thanks to bcarrell for his awesome work on this.