Recommended
Install from crates.io
Get the latest published binary with Cargo.
cargo install nvmman
nvmmanRUST · RATATUI · NVM
Keep every Node
installation in sync.
nvmman is a native terminal UI for maintaining nvm Node.js installations and global npm packages — with safe restores, architecture checks, and one-by-one updates.
Install
cargo install nvmmanRun
nvmmanUpdate
nvmman updateBuilt with
Rust + ratatui00
See it in action
Explore the real terminal screens before you install. Each view maps to a part of the nvm maintenance workflow.
01
Quick start
Install nvmman, launch the dashboard, and let it inspect your local nvm setup.
cargo install nvmman
nvmmannvmman expects nvm in ~/.nvm, or at the path in NVM_DIR. The first screen refreshes your local machine state and the Node.js release index.
02
Installation
Choose the path that fits your workflow.
From source
Build locally
Clone the repository and run a release build.
git clone https://github.com/handyutils/nvmman
cd nvmman
cargo run --releaseRequirementsRust 1.88+nvmNode.js release index accessUnix-like host
03
Usage
Five views keep the maintenance loop visible and actionable.
04
Commands & actions
Search this page to jump straight to a capability or keyboard action.
No matches. Try searching for “registry”, “architecture”, or “update”.
05
How it works
nvmman keeps the local maintenance flow understandable and reversible.
01Inspect
Read nvm installations, the current default Node, host architecture, and global packages.
02Record
Consolidate package occurrences into ~/.nvm/global-packages-registry.json.
03Restore
Install registry packages into the default Node only after the target is ready.
06
Configuration
Set NVM_DIR when nvm lives somewhere other than the standard home directory.
| Setting | Default | Purpose |
|---|---|---|
NVM_DIR | ~/.nvm | Location of nvm and the registry. |
| Registry | ~/.nvm/global-packages-registry.json | Durable package inventory across Node versions. |
| Node index | https://nodejs.org/dist/index.json | Official source for the newest LTS. |
07
Troubleshooting
Common checks when the first refresh cannot inspect your environment.
nvm was not found
Install nvm or set NVM_DIR to the directory containing nvm.sh.
The latest LTS cannot be fetched
Ensure the machine can reach nodejs.org. nvmman uses the official JSON release index.
A package restore failed
nvmman keeps the existing package until a replacement succeeds. Correct the npm or Node environment and retry.
08
Reference
Useful links for releases, source, and licensing.