syl20bnr/evil-lisp-state is a Emacs Lisp project with 91 stars. An evil state to navigate Lisp code and modify it with smartparens
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Adds a new evil state to navigate lisp code and edit sexp trees
using mnemonic key bindings.
Table of Contents
evil-lisp-state
Install
Package manager
Manually
Principle
Commands and key bindings
Configuration
Install
Package manager
You can either install evil-lisp-state from MELPA:
M-x package-install evil-lisp-state
Or add it to your Cask file:
(source melpa)
(depends-on "evil-lisp-state")
Manually
Add evil-lisp-state.el to your load path. evil-lisp-state requires
both evil, bind-map and smartparens to be installed.
Principle
To execute a command while in normal state, a leader key is used.
The leader has to be defined with the function evil-lisp-state-leader.
By default any command when executed sets the current state to lisp state.
Examples:
to slurp three times while in normal state:
3 s
to wrap a symbol in parenthesis then slurping two times:
w 2 s
Key Bindings
Key Binding
Function
<leader> .
switch to lisp state
<leader> %
evil jump item
<leader> :
ex command
<leader> (
insert expression before (same level as current one)
<leader> )
insert expression after (same level as current one)
<leader> $
go to the end of current sexp
<leader> ` k
hybrid version of kill sexp (can be used in non lisp dialects)
<leader> ` p
hybrid version of push sexp (can be used in non lisp dialects)
<leader> ` s
hybrid version of slurp sexp (can be used in non lisp dialects)
<leader> ` t
hybrid version of transpose sexp (can be used in non lisp dialects)
<leader> 0
go to the beginning of current sexp
<leader> a
absorb expression
<leader> b
forward barf expression
<leader> B
backward barf expression
<leader> c
convolute expression
<leader> ds
delete symbol
<leader> Ds
backward delete symbol
<leader> dw
delete word
<leader> Dw
backward delete word
<leader> dx
delete expression
<leader> Dx
backward delete expression
<leader> e
unwrap current expression and kill all symbols after point
<leader> E
unwrap current expression and kill all symbols before point
<leader> h
previous symbol
<leader> H
go to previous sexp
<leader> i
switch to insert state
<leader> I
go to beginning of current expression and switch to insert state
<leader> j
next closing parenthesis
<leader> J
join expression
<leader> k
previous opening parenthesis
<leader> l
next symbol
<leader> L
go to next sexp
<leader> p
paste after
<leader> P
paste before
<leader> r
raise expression (replace parent expression by current one)
<leader> s
forwared slurp expression
<leader> S
backward slurp expression
<leader> t
transpose expression
<leader> u
undo
<leader> U
got to parent sexp backward
<leader> C-r
redo
<leader> v
switch to visual state
<leader> V
switch to visual line state
<leader> C-v
switch to visual block state
<leader> w
wrap expression with parenthesis
<leader> W
unwrap expression
<leader> y
copy expression
Configuration
No default binding comes with the package, you have to explicitly
bind the lisp state to a key with the function evil-lisp-state-leader
For instance:
(evil-lisp-state-leader ", l")
Key bindings are set only for emacs-lisp-mode by default. It is possible to
add major modes with the variable `evil-lisp-state-major-modes'.
It is also possible to define the key bindings globally by setting
evil-lisp-state-global to t. In this case `evil-lisp-state-major-modes' has no
effect.
If you don't want commands to enter in lisp state by default set the variable
evil-lisp-state-enter-lisp-state-on-command to nil. Then use the
. to enter manually in lisp state
Yes — syl20bnr/evil-lisp-state ships under the GPL-3.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/syl20bnr/evil-lisp-state.
What is syl20bnr/evil-lisp-state?
syl20bnr/evil-lisp-state (syl20bnr/evil-lisp-state) is a Emacs Lisp project on GitHub. From the project's own README: An evil state to navigate Lisp code and modify it with smartparens
Where do I read more about syl20bnr/evil-lisp-state?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/syl20bnr/evil-lisp-state is the definitive source.
Read full README in the tab above.
Curious whether evil-lisp-state is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about evil-lisp-state.
/evil-lisp-state