Skip to main content

Migrating from nvm

This guide helps nvm users transition to OMG's blazing-fast Node.js version management.

Why Migrate?

FeaturenvmOMG
Version Switch100-200ms1-2ms (100x faster)
Shell Startup100-500ms<10ms
ImplementationBash scriptPure Rust binary
Other Runtimes✅ Python, Go, Rust, Ruby, Java, Bun

Command Mapping

nvmOMGNotes
nvm install 20omg use node 20Install + activate
nvm use 20omg use node 20Activate (installs if needed)
nvm lsomg list nodeList installed versions
nvm ls-remoteomg list node --availableList available versions
nvm currentomg which nodeShow active version
nvm uninstall 18omg use node --uninstall 18Remove version

Shell Configuration

Remove nvm

Remove from ~/.zshrc or ~/.bashrc:

# Remove these lines:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Add OMG

# Add to ~/.zshrc
eval "$(omg hook zsh)"

Version File Support

OMG automatically detects:

  • .nvmrc
  • .node-version
  • .tool-versions
  • package.json engines

Next Steps