https://github.com/peter-bread/neovim-manager
Manage Stable and Nighly Neovim Builds
https://github.com/peter-bread/neovim-manager
bash cli linux macos manager neovim nightly stable unix-like version-manager zsh
Last synced: 28 days ago
JSON representation
Manage Stable and Nighly Neovim Builds
- Host: GitHub
- URL: https://github.com/peter-bread/neovim-manager
- Owner: peter-bread
- License: mit
- Created: 2025-03-25T20:58:35.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-21T01:21:30.000Z (5 months ago)
- Last Synced: 2025-05-21T01:32:34.103Z (5 months ago)
- Topics: bash, cli, linux, macos, manager, neovim, nightly, stable, unix-like, version-manager, zsh
- Language: Shell
- Homepage:
- Size: 23.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# neovim-manager
> [!WARNING]
> This is still in active development.
>
> It should not be considered stable until v1.0.0.
>
> Methods for installing, updating and uninstalling this software ***WILL***
> be changing.
Simple CLI tool to install and switch between latest stable and nightly
builds of Neovim.
> [!NOTE]
> Intended for use on Unix-like systems.
## Requirements
- `bash` 4.0 or higher
- `wget`/`curl`
- `tar`
## Install
> [!TIP]
> Always check scripts before running them.
> See [here](https://raw.githubusercontent.com/peter-bread/neovim-manager/refs/heads/main/scripts/install)
> to see the installation script for this software.
Installation of script and manpages to `$HOME/.local/bin` and
`$HOME/.local/share/man` respectively. (no `sudo`):
```sh
curl -fsSL https://raw.githubusercontent.com/peter-bread/neovim-manager/refs/heads/main/scripts/install | bash
```
```sh
wget -qO- https://raw.githubusercontent.com/peter-bread/neovim-manager/refs/heads/main/scripts/install | bash
```
### Options
Set these variables to anything non-zero to enable them:
- `MINIMAL`: only install script; no manpages
- `SYSTEM_WIDE`: install to `/usr/local/bin` and `/usr/share/man` (needs `sudo`)
```sh
MINIMAL=1 SYSTEM_WIDE=1 bash <(curl -fsSL https://raw.githubusercontent.com/peter-bread/neovim-manager/refs/heads/main/scripts/install)
```
```sh
MINIMAL=1 SYSTEM_WIDE=1 bash <(wget -qO- https://raw.githubusercontent.com/peter-bread/neovim-manager/refs/heads/main/scripts/install)
```
## Usage
Initialise in shell. Add the following to your shell rc file:
```sh
eval "$(neovim-manager init)"
```
Install (or update):
```sh
neovim-manager install stable
```
Use:
```sh
neovim-manager use stable
```
Uninstall:
```sh
neovim-manager uninstall stable
```
## Uninstall
Run:
```sh
neovim-manager self-destruct
```
## Under the Hood
`neovim-manager` fetches tarballs from the Neovim GitHub releases page. These are
then extracted and stored locally. It will first attempt to store these in
`$XDG_DATA_HOME/neovim-manager/`, but if that environment variable is not set
than it will fall back to `$HOME/.local/share/neovim-manager/`.