https://github.com/jrop/nvimv
Small, simple, Neovim version manager
https://github.com/jrop/nvimv
Last synced: 10 months ago
JSON representation
Small, simple, Neovim version manager
- Host: GitHub
- URL: https://github.com/jrop/nvimv
- Owner: jrop
- Created: 2025-09-28T21:37:51.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-28T21:49:29.000Z (10 months ago)
- Last Synced: 2025-10-08T23:06:50.849Z (10 months ago)
- Language: Shell
- Size: 7.81 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# nvimv 🚀
**The simple Neovim version manager**
Easily install, manage, and switch between different versions of Neovim without the hassle. Perfect for testing new features, maintaining compatibility, or just keeping your setup organized.
## 📚 Table of Contents
- [✨ Features](#-features)
- [🚀 Quick Start](#-quick-start)
- [📋 Commands](#-commands)
- [💡 Common Workflows](#-common-workflows)
- [🛠️ Installation](#️-installation)
- [📄 License (MIT)](#-license-mit)
## ✨ Features
- 🔄 **Switch versions instantly** - Jump between Neovim versions with a single command
- 📦 **Auto-download & install** - Fetches official releases directly from GitHub
- 🏗️ **Build from source** - Install specific commits, branches, or tags from git
- 🏗️ **Cross-platform** - Works on Linux and macOS (Intel & Apple Silicon)
- 🎯 **Zero configuration** - Works out of the box with sensible defaults
- 🧹 **Clean management** - Easy installation, upgrade, and removal
## 🚀 Quick Start
```bash
# Install the latest stable version
nvimv install stable
# Use it as your default nvim
nvimv use stable
# That's it! Now `nvim` runs the version you selected
nvim --version
```
## 📋 Commands
| Command | Description | Example |
| ------------- | -------------------------------- | ------------------------------ |
| `install` | Install a specific version | `nvimv install v0.9.0` |
| `use` | Switch to a version | `nvimv use stable` |
| `exec` | Run nvim with a specific version | `nvimv exec nightly --version` |
| `list` | Show installed versions | `nvimv list` |
| `list-remote` | Show available versions | `nvimv list-remote` |
| `upgrade` | Upgrade an installed version | `nvimv upgrade stable` |
| `remove` | Remove a version | `nvimv remove v0.8.0` |
| `env` | Show environment for a version | `nvimv env stable` |
## 💡 Common Workflows
### Try the latest features
```bash
# Install and test nightly builds
nvimv install nightly
nvimv exec nightly # Test without switching your default
```
### Build from source (git refs)
```bash
# Install from a specific commit
nvimv install git_abc1234
# Install from a branch
nvimv install git_master
# Install from a tag
nvimv install git_v0.10.0
# Use a git build
nvimv use git_master
```
**Note:** Git refs are built from source and cannot be upgraded. Use `remove` then `install` to update them.
### One-off commands for specific versions
```bash
# Use different versions for different projects
cd my-old-project && nvimv exec v0.8.0
cd my-new-project && nvimv exec nightly
```
### Clean up old versions
```bash
# See what you have installed
nvimv list
# Remove versions you don't need
nvimv remove v0.7.0
```
## 🛠️ Installation
### Quick Install (Recommended)
```bash
# Download and run the install script
curl -fsSL https://raw.githubusercontent.com/jrop/nvimv/main/install | bash
```
### Custom Installation
```bash
# Install to a custom directory
NVIMV_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/jrop/nvimv/main/install | bash
# Or with a custom prefix
PREFIX=/opt/local curl -fsSL https://raw.githubusercontent.com/jrop/nvimv/main/install | bash
```
### Manual Installation
1. Download the `nvimv` script
2. Make it executable: `chmod +x nvimv`
3. Put it in your PATH (e.g., `mv nvimv ~/.local/bin/`)
**Dependencies:** `curl`, `jq`, `git`, `make`, `cmake` (git refs only)
## 📄 License (MIT)
Copyright (c) 2025 Jonathan Apodaca
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
This project is open source. Check the repository for license details.