Multiple cursors for evil-mode, inspired by vim-visual-multi.

• Two modes: cursor mode (point cursors, operators need motions) and extend mode (selections, operators act directly)
• Leader cursor with distinct highlighting
• Per-cursor registers for yank/paste (1-to-1 distribution)
• Evil movements, text objects, and operators at all cursors
• evil-surround integration (S, ys, ds, cs)
• Run normal commands, macros, or ex commands at all cursors
• Restriction: limit search to a region
• Undo/redo with automatic cursor resync
• Theme-aware faces with auto-adaptation

(use-package evim
  :after evil
  :config
  (evim-setup-global-keys))

In packages.el:

(package! evim)

In config.el:

(use-package! evim
  :after evil
  :config
  (evim-setup-global-keys))

Then run doom sync and restart Emacs.

Doom may rebind some keys used by evim (e.g. C-n, C-Down, C-Up). If you encounter conflicts, override them in config.el:

;; Example: unbind C-n in Doom before evim takes over
(map! :n "C-n" nil)

Before the package is on MELPA, install directly from GitHub:

;; packages.el
(package! evim :recipe (:host github :repo "Prgebish/evim"))

Clone the repository, add it to load-path, and set up keys:

(add-to-list 'load-path "/path/to/evim")
(require 'evim)
(evim-setup-global-keys)

1. Place cursor on a word, press C-n — the word is selected
2. Press n to add the next match, q to skip, Q to remove
3. Press Tab to switch between cursor/extend mode
4. Edit at all cursors: c, d, i, a, r, etc.
5. Press Esc to exit evim

The default leader key is \ (backslash). Customise with evim-leader-key.

Surround commands are accessed through the standard evil operators:

All customizable variables with their defaults:

;; Leader key for prefix commands (\ A, \ a, \ r, \ z, \ @, \ :, \ g S)
;; Call (evim-rebind-leader) after changing to update keymaps.
;; Default: "\\"
(setq evim-leader-key "\\")

;; Color theme for cursor and region overlays.
;; Values: 'default, 'iceblue, 'ocean, 'neon, 'purplegray, 'nord,
;;         'codedark, 'spacegray, 'olive, 'sand, 'paper,
;;         'lightblue1, 'lightblue2, 'lightpurple1, 'lightpurple2
;; Dark themes:  iceblue, ocean, neon, purplegray, nord, codedark, spacegray, olive, sand
;; Light themes: lightblue1, lightblue2, lightpurple1, lightpurple2, paper, sand
;; Default: 'default
(setq evim-theme 'default)

;; How to highlight other pattern matches in the buffer.
;; Values: 'underline, 'background, nil (disable)
;; Default: 'underline
(setq evim-highlight-matches 'underline)

;; Show EVM[C 1/3] indicator in the mode-line.
;; Values: t, nil
;; Default: t
(setq evim-show-mode-line t)

The guide/ directory contains a hands-on tutorial in 5 parts:

1. 01-cursors-and-navigation.txt — creating cursors and moving around
2. 02-editing.txt — insert mode, operators, text objects, registers, surround
3. 03-run-at-cursors.txt — \ z, \ @, \ :
4. 04-restrict.txt — limiting search to a region
5. 05-undo-and-reselect.txt — undo, redo, reselect last session

Open any file in Emacs and follow the exercises directly in the buffer.

Inspired by vim-visual-multi by mg979.

If you find evim useful, consider giving it a star — it helps others discover the project.

MIT