nvs
Neovim Version Switcher – Install, switch, and manage multiple Neovim versions with ease 🚀
---
Why nvs?
Managing multiple Neovim versions shouldn't be complicated. nvs makes it simple:
- ⚡ Instant Switching – Switch between versions in milliseconds
- 📌 Per-Project Versions – Pin versions with .nvs-version files
- 🔄 Auto-Switch – Automatically switch versions when changing directories
- 🌙 Nightly Support – First-class support for nightly builds with rollback capability
- 🔧 Build from Source – Install any commit directly from the Neovim repository
- 🔀 Config Switching – Toggle between multiple Neovim configurations
- 🩺 Self-Diagnosing – Built-in health checks with nvs doctor
$ nvs use stable
✓ Switched to Neovim stable
$ nvim -v
NVIM v0.10.4
Build type: Release
LuaJIT 2.1.1713484068
$ nvs use nightly
✓ Switched to Neovim nightly
$ nvim -vBuild type: RelWithDebInfo LuaJIT 2.1.1741571767
---
## Quick Start
### 1. Install nvs
**macOS / Linux:**
curl -fsSL https://raw.githubusercontent.com/y3owk1n/nvs/main/install.sh | bash
**Windows (PowerShell):**
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/y3owk1n/nvs/main/install.ps1" -OutFile "install.ps1"; .\install.ps1
**Other methods:** [Homebrew](docs/INSTALLATION.md#method-2-homebrew-macoslinux) · [Nix](docs/INSTALLATION.md#method-4-nix-flakes) · [From Source](docs/INSTALLATION.md#method-5-build-from-source)
### 2. Set Up Your Shell
Add to your shell configuration (`~/.bashrc`, `~/.zshrc`, or `~/.config/fish/config.fish`):
Bash/Zsh
eval "$(nvs env --source)"
Fish
nvs env --source | source