A powerful Visual Studio Code extension to switch and install Node.js from the status bar and sidebar using nvm (Node Version Manager). It detects your project's requirements, warns you of mismatches, and syncs your integrated terminals.
Features
🟢 Status Bar & Version Picker
- Real-time UI: Shows the currently active Node version.
- Quick Pick: Click the Status Bar item to open a version picker showing installed versions.
- Project Mismatch Warning: If your active Node version doesn't match the project's
.nvmrcorpackage.json, the status bar changes color to warn you.
📁 Project Declaration Scan
NodeSwitcher determines a "project" Node expectation by consulting sources in order:
.nvmrcpackage.json(engines.node)
💻 Terminal Environment Sync
When you switch versions, the extension updates VS Code's environment API (PATH). Newly opened terminals will automatically use the selected Node version.
Requirements
- macOS / Linux:
nvmmust be installed and available in your environment (~/.zshrcor~/.bashrc). - Windows:
nvm-windowsmust be on yourPATH. - VS Code: ^1.110.0 or newer. A folder opened as a workspace is recommended.
Quick Start
- Install
nvm(Unix) ornvm-windows(Windows). - Install this extension.
- Click the Node entry in the status bar to choose a version.
- In integrated terminals, run
node -vto confirm the switch.
Developed by Owen Lobato | Built for developers who switch contexts between projects seamlessly.