A simple bash script to manage multiple Neovim versions on your system. Allows you to easily install, switch between, and run different Neovim versions without affecting your system's default installation.

• Install specific Neovim versions (stable, latest, nightly, or any semver)
• Switch between installed versions with a single command
• Run specific versions without switching
• SHA-256 checksum verification on every install
• Installs man page, .desktop file, and icons (XDG paths)
• Interactive version picker with fzf (if installed)
• Shell completions for zsh and bash
• Lightweight and fast, with minimal dependencies

Currently supported on Linux only.

• curl, jq, sha256sum
• fzf (optional) — enables interactive version picker

Via make:

git clone https://github.com/sarmong/nvvm.git
cd nvvm
make install

Detects your shell and installs completions for zsh or bash automatically.

Manual:

git clone https://github.com/sarmong/nvvm.git
cp nvvm/nvvm ~/.local/bin/nvvm

Add to your shell config (~/.zshrc or ~/.bashrc):

export PATH="${XDG_DATA_HOME:-$HOME/.local/share}/nvvm/bin:$PATH"

This also makes nvim-stable, nvim-latest, and nvim-<version> available as direct executables alongside the default nvim.

Zsh completions:

fpath=("$HOME/.local/share/zsh/site-functions" $fpath)
autoload -Uz compinit && compinit

<version> accepts stable, latest, full semver (0.10.0), partial semver (0.10), or nightly. Omitting <version> for install, use, run, and uninstall opens an fzf picker.

Via make:

make uninstall

Manual:

rm ~/.local/bin/nvvm
rm ~/.local/share/zsh/site-functions/_nvvm
rm ~/.local/share/bash-completion/completions/nvvm

To also remove all installed Neovim versions and nvvm data:

rm -rf "${XDG_DATA_HOME:-$HOME/.local/share}/nvvm"
rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}/nvvm"