  ____             _
 |  _ \ ___ _ __ | | __ _  ___ ___ _ __
 | |_) / _ \ '_ \| |/ _` |/ __/ _ \ '__|
 |  _ <  __/ |_) | | (_| | (_|  __/ |
 |_| \_\___| .__/|_|\__,_|\___\___|_|
           |_|                     .nvim

replacer.nvim

Project-wide search-and-replace where every occurrence is its own decision. ripgrep finds the matches, a picker — fzf-lua or Telescope — lets you select them one by one with the hit highlighted in the preview, and nothing is written before you have had the chance to look at a diff.

status: beta — Beta stage — active development. This repository is past its first shape and in active use, but the surface is not frozen: breaking changes are still possible. Pin a commit or tag if you depend on it.
category: Editing
neovim: 0.9+
repo: github.com/StefanBartl/replacer.nvim
commits: 174
help: :help replacer

demo

recorded with VHS from demos/replacer.tape in a clean Neovim — re-recorded weekly

what is shown when

:Replace old new --dry - plan first, write nothing
:Replace old new --all - apply everywhere

install

{
  "StefanBartl/replacer.nvim",
  opts = {},
}

docs/

git log

2026-09-29 fix regex: :ReplaceTest panel now themed via ui.kit, not hardcoded rounded
2026-09-29 docs bindings: document the engine-native preview navigation keys
2026-09-28 refactor debug: dump inspect_buffer/analyze_line via lib.nvim.output.viewer
2026-09-24 docs link back to the wkd family site
2026-09-21 perf gitfiles: --changed asks git once instead of up to three times
2026-09-21 ci bump leafo/gh-actions-lua and gh-actions-luarocks off Node 20
2026-09-21 ci bump JohnnyMorganz/stylua-action to v5 (Node-20 deprecation)
2026-09-21 ci bump the failure-log upload to upload-artifact@v7; make test runs swap/shada-free
2026-09-21 ci pin ui/documentation/pickers checkouts to their ci-verified branch
2026-09-21 ci add job timeouts, failure log artifacts, swap/shada-free nvim runs, pinned deps
2026-09-21 refactor regex: rename escape_and_report to escape_to_register (PRIN-02)
2026-09-20 docs remove emoji and bold-as-heading from docs (LUA-54)