Bum - Bun Version Manager

Introducing Bum, a fast Bun version manager written in Rust from scratch.

How to install:

Via npm/npx (Recommended)

The easiest way to use Bum is via npm:

# Use without installation
npx @owenizedd/bum use 1.0.3

# Or install globally
npm install -g @owenizedd/bum
bum use 1.0.3

Via Script (Unix)

Unix

If npm/npx doesn't work, you can fallback to Rust binary:

1. Open your terminal and execute:

curl -fsSL https://github.com/owenizedd/bum/raw/main/install.sh | bash

This installation will install bun for you and also bum altogether.

Windows

I only own a Mac, so I can't test at all if Windows is working, and I can't write a script to auto-install on Windows as well. So here are a few instructions on how to install Bum for Windows:

1. Install Bun
2. Download the last exe in the latest release, and unzip it
3. Put the exe in your favorite directory, add the path to this directory in your PATH, and that's it!

As Bum is not tested at all on Windows, it may not works. If it's the case please open an issue and I'll be glad to fix it.

How to use:

• You can just run bum without any parameter to see default help menu.

Commands

• bum use <version>

  • Change the current active bun version, e.g. bum use 1.0.3. This will automatically use v1.0.3.
  • If there's no target version is installed in the local, it will install that version then use it.
  • Else, it will just use that version directly as the active version.

• bum remove <version>

  • Remove the installed version locally.

    This feature will only remove local copy, but if you're using the removed version, you will still be able to use that version, but once you change to other version, you will not be able to change to that version anymore.

  • In the future we will automatically switch to the latest version available upon removal of the version.

• bum list

  • Show all local installed versions of Bun.

• bum list-remote

  • Show all remote versions of Bun that could be installed.

• .bumrc file

  • When file exists, everytime you use bum use command without <version> argument, Bum will try to use the version from the .bumrc file.

Future features (possibly)

• bum default <version>

Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Development setup
• Running tests
• Code style guidelines
• Pull request process

For maintainers releasing new versions, see the Release Guide.

Questions or Issues?

• 💬 Have questions? Open a Discussion
• 🐛 Found a bug? Open an Issue
• 💡 Have ideas? We'd love to hear them!

License

MIT