Thanks for the ⭐ but you may have been sent to the wrong place. This repo is my guide to mise that maybe should've been a gist 😅

mise (mise-en-place) is a CLI tool that can manage multiple language runtime versions on a per-project basis. It's like asdf but faster. It's also like gvm, nvm, rbenv, tfenv & pyenv (and more) all in one! (formerly called "rtx")

brew install mise

echo 'eval "$(mise activate zsh)"' >> ~/.zshrc

echo 3.11 > .python-version # Python example
echo 20.5.1 > .node-version # Node example

Given missing tools specified in local version files (e.g. [WARN] Tool not installed: [email protected])

mise install

If mise install is not working and you're not getting a warning (e.g. [WARN] Tool not installed: [email protected]) when there is an existing idiomatic version file (e.g. .terraform-version) you may need to install the corresponding plugin

mise plugins install terraform

Sets a tool version for the current shell session. Useful if you're doing something quick and don't want to set a global or local version.

mise shell node@lts

If you're sure you want to have a specific version always available then you can set a global version

mise use -g node@lts
mise use -g [email protected]
mise use -g rust@latest

In order to automatically switch to the correct version of your runtime(s) when you're working on different projects it's useful to store the version number in a file in a project's directory.

mise supports idiomatic version files (just like asdf). They're language-specific files like .node-version and .python-version. These are ideal for setting the runtime version of a project without forcing other developers to use a specific tool like mise/asdf.

They support aliases, which means you can have an .nvmrc file with lts/hydrogen and it will work in mise and nvm. Here are some of the supported legacy version files:

.mise.toml is the native version file that is more customisable but requires that project collaborators use mise.

.tool-versions is the asdf version file that supports multiple tools in one file but requires that project collaborators use asdf or mise.