With Tab Completion!

The Ultimate Bun
Version Manager

Fast, simple, and powerful. Manage multiple Bun versions with zero dependencies.

Terminal 
$ curl -fsSL https://install.bunvm.com | bash
Get Started View on GitHub
0
Dependencies
<1s
Install Time
∞
Versions
2
Platforms

Why Choose BunVM?

Built for developers who demand simplicity and speed

Lightning Fast

Zero dependencies. Pure shell script. Instant version switching.

Auto-Switching

Automatically detects .bun-version files. No manual switching needed.

Tab Completion

Smart autocompletion for both Bash and Zsh.

Multiple Versions

Install and manage unlimited Bun versions.

Version Aliases

Create memorable names for versions.

Cross-Platform

Works seamlessly on macOS and Linux.

Quick Installation

Get started in seconds

Install

$ curl -fsSL https://install.bunvm.com | bash

Installs BunVM to ~/.bunvm and sets up your shell.

Uninstall

$ curl -fsSL https://uninstall.bunvm.com | bash

Completely removes BunVM and all installed versions.

First Steps After Installation 

# Install the latest version of Bun
$ bunvm install latest

# Verify installation
$ bun --version
1.3.4

# Check current version
$ bunvm current
✓ Version actual: 1.3.4

Essential Commands

Everything you need to manage Bun versions

bunvm install <version>

Install a specific version of Bun

$ bunvm install latest
$ bunvm install 1.0.25
bunvm use <version>

Switch to a specific version (persists across shells)

$ bunvm use 1.0.25
✓ Ahora usando Bun 1.0.25
bunvm list [--local]

List available or installed versions

$ bunvm list --local
 Version    | Status      | Use | Path
 1.0.25     | installed*  | *   | ~/.bunvm/versions/bun-1.0.25

Real-World Examples

See BunVM in action

Multiple Projects

Different projects, different Bun versions. No manual switching needed.

# Project A
$ cd ~/projects/project-a
$ echo "1.0.25" > .bun-version
# Auto-switches to 1.0.25! 🎉

# Project B
$ cd ~/projects/project-b
$ echo "1.0.20" > .bun-version
# Auto-switches to 1.0.20! 🎉

Testing Beta Features

Test new features without breaking your workflow.

# Setup versions
$ bunvm install 1.0.25
$ bunvm alias stable 1.0.25
$ bunvm install 1.1.0
$ bunvm alias beta 1.1.0

# Easy switching
$ bunvm use beta
# Test features...
$ bunvm use stable

Team Collaboration

Ensure everyone uses the same Bun version.

# In your project
$ echo "1.0.25" > .bun-version
$ git add .bun-version
$ git commit -m "Pin Bun version"

# Team members:
$ git clone <repo>
$ cd <repo>
# BunVM auto-detects version! 🤝

CI/CD Integration

Perfect for GitHub Actions and other CI/CD pipelines.

# .github/workflows/test.yml
- name: Install BunVM
  run: |
    curl -fsSL https://install.bunvm.com | bash

- name: Install Bun
  run: |
    source ~/.bashrc
    bunvm install $(cat .bun-version)

- name: Run tests
  run: bun test

FAQ

Answers to common questions about BunVM

What is BunVM?
BunVM is a lightweight version manager for Bun. It focuses on speed, simplicity, and zero external dependencies, making it ideal for developer machines and CI.
How does auto-switching work?
BunVM detects a .bun-version file in your project and switches to the specified version when entering the directory. Leaving the directory restores the previous version.
Does BunVM require sudo or system changes?
No. BunVM operates within your home directory and updates shell configuration files as needed. It never requires elevated privileges.
Is BunVM compatible with macOS and Linux?
Yes. BunVM officially supports macOS and Linux. Installation and version switching are consistent across platforms.
How do aliases help?
Aliases let you give memorable names to versions, like stable or beta, so you can switch quickly without remembering exact version numbers.
Can I use BunVM in CI?
Absolutely. BunVM is ideal for CI/CD pipelines. Use the install script and the project’s .bun-version to pin versions during builds and tests.
Does BunVM support shell completion?
Yes. BunVM provides smart autocompletion for Bash and Zsh, helping you discover commands and versions faster.
How can I uninstall BunVM?
Run $ curl -fsSL https://uninstall.bunvm.com | bash. This removes BunVM and all installed versions from your system.

Ready to Get Started?

Join developers who manage Bun versions the smart way

$ curl -fsSL https://install.bunvm.com | bash
View on GitHub Read Documentation