Skip to content
NoetherVim is alpha. Breaking changes land without deprecation shims. These docs track main.

Managing your install

Run :Lazy update inside Neovim. This updates the distro and all plugins.

Once you’re running, you can bring over your personal settings:

  • Plugins: add lazy.nvim specs to lua/user/plugins/ (see Configuration)
  • Options/keymaps/autocmds: check what the distro defaults to before re-adding (type :NoetherVim diff {keymaps/options} to check out the distro’s keymaps)
  • LSP configs: NoetherVim configures servers through lua/noethervim/lsp/; if you had custom server settings, look there first

Quick crash course: the following are important files/locations for any Neovim setup

Path Contents
~/.config/nvim/init.lua Neovim’s entry point that bootstraps your personal config
~/.config/nvim/lua/user/ Your plugin specs, option/keymap/autocmd overrides
~/.config/nvim/lazy-lock.json Your pinned plugin versions
~/.local/state/nvim/ Shada (command/search history, marks, registers), undo history, sessions, views
~/.local/share/nvim/site/spell/ Custom spell additions

Everything else under ~/.local/share/nvim/ and ~/.cache/nvim/ is installed or generated by the distro and can be regenerated by relaunching Neovim.

To reset the distribution and keep personal data, run

Terminal window
rm -rf ~/.local/share/nvim ~/.cache/nvim

This wipes installed plugins (lazy.nvim, NoetherVim, everything else), Mason-managed LSP servers and formatters, and all caches. Your init.lua, lua/user/, and editing state (history, undo, sessions) stay intact. Next launch re-bootstraps and reinstalls everything from scratch.

To reset the distribution and editing state

Terminal window
rm -rf ~/.local/share/nvim ~/.local/state/nvim ~/.cache/nvim

Same as above but also drops shada, undo history, sessions, and views. Config is still preserved.

To fully uninstall

Terminal window
rm -rf ~/.config/nvim ~/.local/share/nvim ~/.local/state/nvim ~/.cache/nvim

Removes the config, data, state, and cache directories. Restore your backup if you made one.