jdx/mise is an open-source project on GitHub, mainly written in Rust. dev tools, env vars, task runner It currently holds 35,854 stars and 1,527 forks with 19 open issues, and was last pushed on 2026-11-06 (repository created 2023-01-09).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #83 with 42 new stars today.
GitHub Repository Details
Repository jdx/mise · default branch main · size 160990 KB · watchers 46 · source: GitHub REST API and repository README
mise (pronounced "meez", short for _mise-en-place_) manages a project's dev
tools, environment variables, and tasks from one mise.toml that works across
your shell, editor, and CI:
Go, Rust, and Terraform from a
registry of 1,000+ tools or directly
from backends like GitHub
releases, Aqua, Cargo, npm, and PyPI, with separate versions per project.
and mise dot apply to apply system
packages, dotfiles, Git repositories, macOS defaults, and background services.
Adopt only the parts you need. Start with a single tool or task, and keep any
existing .tool-versions files as they are; mise also reads .nvmrc,
.python-version, and other
idiomatic version files
once enabled.
curl -fsSL https://mise.run | sh
~/.local/bin/mise --version
On Windows, run winget install jdx.mise. For Homebrew, apt, dnf, Scoop, and
other package managers, see
Installing mise.
The installer places the binary at ~/.local/bin/mise. If ~/.local/bin is not
on your PATH yet, run ~/.local/bin/mise in place of mise until you
activate mise in step 4.
2. Run a tool without changing your shell
mise exec node@24 -- node --version
v24.x.x
mise exec downloads Node.js 24 if
needed and runs the command after -- with that version on PATH. Your shell
and config files stay untouched.
3. Configure a project
Create a project directory, select Node.js 24, set an environment variable, and
add a task:
mkdir my-project && cd my-project
mise use node@24
mise set NODE_ENV=development
mise tasks add hello -- node -e "console.log(process.version, process.env.NODE_ENV)"
These commands install Node.js 24 and write mise.toml:
[tools]
node = "24"
[env]
NODE_ENV = "development"
[tasks.hello]
run = 'node -e "console.log(process.version, process.env.NODE_ENV)"'
Commit mise.toml so teammates and CI get the same setup when they run
mise install or mise run. "24" requests the latest release in the Node.js
24 series; run mise lock to record exact versions and checksums in a
lockfile, or
mise use --global node@24 to set a personal default in
~/.config/mise/config.toml.
4. Activate mise in your shell (optional)
Shell activation updates PATH and project environment variables whenever you
change directories, so you can invoke node directly without mise exec. If
you installed with mise.run, run the command for your shell once, then open a
new terminal:
If a package manager installed mise, use mise in place of ~/.local/bin/mise.
With Homebrew, fish activates mise without this step.
For PowerShell, Nushell, Elvish, Xonsh, and IDE or CI shims, see
Shell setup and
Shims.
Everyday commands
| Command | Action |
| --------------------------- | ----------------------------------------------------------------- |
| mise use node@24 | Install a tool and record it in the current project's mise.toml |
| mise use --global node@24 | Install a tool and set it as your global default |
| mise install | Install all tools declared in the active config files |
| mise exec -- | Run a command with the project's tools and environment |
| mise run | Run a project task with its dependencies, tools, and environment |
| mise set KEY=value | Set an environment variable in mise.toml |
| mise env | Print the resolved environment variables and PATH changes |
| mise ls --current | List the tool versions active in the current directory |
| mise outdated | List tools with newer releases than the installed version |
| mise upgrade | Install those newer releases |
| mise lock | Write exact tool versions and checksums to mise.lock |
| mise config ls | Show the config files loaded for the current directory |
| mise doctor | Check your mise installation, shell activation, and configuration |
Set up a machine with mise bootstrap
Beyond project directories, ~/.config/mise/config.toml can declare the state
of your machine:
Troubleshooting first, and
include the command you ran, a minimal mise.toml, the expected and actual
behavior, and your mise doctor output after reviewing it for private
details.