A fast and simple JavaScript runtime version manager for Node.js, Bun, and Deno.

• 🚀 Fast & Lightweight - Minimal overhead with efficient version switching
• 🎯 Auto-Detection - Automatically detect and use project-specific runtime versions
• 📁 Project-Based - Support for .node-version files and package.json devEngines
• 📦 Version Range Support - Use semantic versioning ranges for flexible version management

# For Linux/macOS. You may need to add `sudo` in front of these two commands.
curl -L "https://github.com/rnmjs/jrm/releases/latest/download/jrm-$(uname -s)-$(uname -m)" -o /usr/local/bin/jrm
chmod +x /usr/local/bin/jrm

Go to the GitHub Releases for more assets.

jrm --version

Add JRM to your shell profile. This step is required for JRM to work properly:

# Add this line to the end of ~/.bashrc or ~/.zshrc
eval "$(jrm env)"

After adding this line, restart your terminal or run source ~/.bashrc (or source ~/.zshrc).

# Set specific Node.js version
jrm use node@18
node --version # -> 18.20.8

# Set multiple runtime versions
jrm use node@22.21.1 bun@1.3.5 deno@2.6.3
node --version # -> 22.21.1
bun --version # -> 1.3.5
deno --version # -> 2.6.3

JRM can automatically detect runtime versions from your project configuration:

echo "22.21.1" > .node-version
echo "1.3.5" > .bun-version
echo "2.6.3" > .deno-version

jrm use

node --version # -> 22.21.1
bun --version # -> 1.3.5
deno --version # -> 2.6.3

JRM will automatically run jrm use when you cd into the directory. That means, when you cd into the directory, JRM will automatically set the runtime versions for you.

Not only .{runtime}-version files, JRM but also supports devEngines in package.json:

{
  "devEngines": {
    "runtime": {
      "name": "node",
      "version": ">=20.0.0"
    }
  }
}

1. Remove JRM directory: rm -rf ~/.jrm
2. Edit shell profile: Remove eval "$(jrm env)" from ~/.bashrc or ~/.zshrc
3. Restart terminal: Run source ~/.bashrc or source ~/.zshrc

• fnm - 🚀 Fast and simple Node.js version manager, built in Rust. (JRM is inspired by this project)
• @rnm/pm - 📦 Unified Package Manager for Node.js (npm, yarn, pnpm)

Contributions are welcome! Please feel free to submit a Pull Request.

# Clone the repository
git clone https://github.com/rnmjs/jrm.git
cd jrm

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build the project
pnpm build

If this project helps you, please give it a ⭐️!

MIT