neomanager

A lightweight version manager for Neovim, written in Bash. Install, switch, and manage multiple Neovim versions with ease.

Features

• Install pre-built Neovim releases from GitHub
• Install nightly builds
• Build from source
• Switch between versions globally or per-project (.nvim-version)
• Automatic version switching when entering project directories
• Supports macOS (Intel & Apple Silicon) and Linux (x86_64, ARM64, ARMv7)

Installation

Quick install (recommended)

curl -fsSL https://raw.githubusercontent.com/homelabshq/neomanager/main/install.sh | bash

Manual install

Clone the repository:

git clone https://github.com/homelabshq/neomanager.git ~/.neomanager

Add to your shell config:

Bash (~/.bashrc):

source ~/.neomanager/neomanager.bash

Zsh (~/.zshrc):

source ~/.neomanager/neomanager.zsh

Then reload your shell:

source ~/.bashrc   # or source ~/.zshrc

Usage

Install a specific version

neomanager install v0.10.0

Install the latest stable version

neomanager install-latest

Install a nightly build

neomanager install nightly

Build from source

neomanager install-source

List installed versions

neomanager list

List available remote versions

neomanager list-remote

Set default version (global)

neomanager use v0.10.0

Set version for current project

neomanager use-local v0.9.5

This creates a .nvim-version file in the current directory. When you cd into this directory, neomanager automatically switches to the specified version.

Show current version

neomanager current

Show path to active binary

neomanager which

Uninstall a version

neomanager uninstall v0.9.5

Check for updates

neomanager update

Use Neovim

Once a version is set, just use nvim as usual:

nvim
nvim file.txt

How It Works

neomanager downloads pre-built Neovim binaries from GitHub releases (or builds from source). Versions are stored in ~/.neomanager/versions/. The active version is tracked in ~/.neomanager/current or per-directory via .nvim-version files.

When you source the shell integration, it:

• Adds the neomanager and nvim commands
• Hooks into cd to automatically detect .nvim-version files

Requirements

• curl and tar (for downloading releases)
• git, make, and cmake (only for building from source)

Supported Platforms

Platform	Architecture	Notes
macOS	Intel (x86_64)	All versions
macOS	Apple Silicon (arm64)	v0.10.0+
Linux	x86_64	All versions
Linux	ARM64 (aarch64)	v0.11.0+

License

MIT