Mise

Tools

Install a tool globally and pin it

mise use --global <tool>@<version>
mise use --global node@22
mise use --global kubectl@latest

Install a tool for the current directory only

mise use <tool>@<version>

Install everything declared in the config

mise install

Remove a tool

mise uninstall <tool>        # removes the install, leaves the config entry
mise unuse --global <tool>   # removes both

Run a command with a tool without installing it globally

mise exec <tool>@<version> -- <command>
mise exec node@20 -- node --version

Upgrades

With pin = true, mise use records an exact version. A plain mise upgrade only upgrades within that constraint, which an exact version already satisfies - so it reports "All tools are up to date" and changes nothing. --bump is what rewrites the pin.

See what is actually behind

mise outdated --bump

Upgrade everything and rewrite the pins

mise upgrade --bump

Upgrade a single tool

mise upgrade --bump <tool>

Upgrade mise itself

brew upgrade mise    # macOS
mise self-update     # installed via mise.run

Backends

Tools missing from the registry are addressed by backend. Prefer aqua: its packages are checksum-verified. asdf plugins are arbitrary shell scripts.

Install from a specific backend

mise use --global aqua:<owner>/<repo>@latest
mise use --global github:<owner>/<repo>@latest
mise use --global pipx:<package>@latest
mise use --global npm:<package>@latest
mise use --global cargo:<crate>@latest
mise use --global go:<module>@latest

Find which backend a registry name resolves to

mise registry | grep <tool>

Inspection

List installed tools and where each is declared

mise ls

List every version available upstream

mise ls-remote <tool>

Show the version that resolves here

mise current
mise which <binary>

Search the registry

mise registry
mise registry | grep <tool>

Configuration

Config file locations, highest precedence first

# ~/.config/mise/config.toml       <- `mise use --global` writes here
# ~/.config/mise/conf.d/*.toml     <- merged in, survives the above
# ./mise.toml                      <- per project

Read or change a setting

mise settings
mise settings get <key>
mise settings set <key> <value>

Regenerate shims after installing globals via npm/go

mise reshim

Activate in a shell

eval "$(mise activate zsh)"                          # interactive shells
export PATH="$HOME/.local/share/mise/shims:$PATH"    # scripts, CI, containers

Troubleshooting

Diagnose a broken install

mise doctor

HTTP 403 while resolving a version

The aqua and github backends resolve through the GitHub API, which rate-limits unauthenticated requests. mise retries 429 and 5xx but treats 403 as permanent.

export GITHUB_TOKEN=<token>

Verbose output for a failing install

MISE_VERBOSE=1 mise install <tool>
mise install <tool> --verbose

Useful environment variables

MISE_YES=1                      # never prompt (CI, container builds)
MISE_PIN=1                      # record exact versions
MISE_DISABLE_BACKENDS=asdf      # keep installs on verifying backends
MISE_DATA_DIR=<path>            # where tools and shims live
MISE_OFFLINE=1                  # use only locally cached data