Home

vilpy is documented in the README.

The purpose of the wiki is to list configurations and tips that do not belong to the main documentation.

Customization

Doom

If you use Doom Emacs, consider using these customizations: (thanks Karl Markets from Doom's Discord)

(defun my-doom-localleader-dispatch ()
  (interactive)
  (set-transient-map
   (lookup-key (current-active-maps) (kbd doom-localleader-alt-key))))

(defun my-doom-leader-dispatch ()
  (interactive)
  (set-transient-map
   (lookup-key (current-active-maps) (kbd doom-leader-alt-key))))

;; otherwise which-key won't be displayed when using the keybindings below
(setq which-key-show-transient-maps t)
;; assuming your localleader is `,`
(vilpy-define-key vilpy-mode-map "," #'my-doom-localleader-dispatch)
;; note that this will override the default `vilpy-space` binding. You might miss it!
(vilpy-define-key vilpy-mode-map "SPC" #'my-doom-leader-dispatch)

paredit-forward-up

The equivalent vilpy command for paredit-forward-up is vilpy-right. It is not bound to any key in the special mode map because it's equivalent to h<TAB> (vilpy-left andvilpy-special).

That said, you can bind to it some key of your preference:

(vilpy-define-key vilpy-mode-map "m" 'vilpy-right)

migrating from lispy

lispy-occur

This command has been removed from vilpy because it's easily replicated by simply narrowing the desired form and using swiper (or whatever occur variant you use).