Tool Aliases

TIP

[alias] has been renamed to [tool_alias] to distinguish it from [shell_alias]. The old [alias] key still works but is deprecated.

For shell command aliases (like alias ll='ls -la'), see Shell Aliases.

Aliased Backends

Tools can be aliased so that something like node which normally maps to core:node can be changed to a different backend instead.

~/.config/mise/config.toml

[tool_alias]
node = 'github:company/our-custom-node'   # shorthand for https://github.com/company/our-custom-node
erlang = 'aqua:company/our-custom-erlang' # use an aqua registry entry

This can also be used to install multiple tools from the same GitHub release:

~/.config/mise/config.toml

[tool_alias]
dhall-json = 'github:dhall-lang/dhall-haskell'
dhall-lsp = 'github:dhall-lang/dhall-haskell'

[tools]
dhall-json = { version = "v1.42.2", matching = "dhall-json" }
dhall-lsp = { version = "latest", matching = "dhall-lsp-server" }

The example above uses the GitHub backend's matching feature to download two distinct binaries from different releases in the same GitHub repository.

Aliased Versions

mise supports aliasing the versions of runtimes. One use-case for this is to define a stable name that points to a specific version, so you can reference it symbolically in mise.toml/.tool-versions. For example, you may want lts-iron to map to Node.js 20 so you can set it with node = "lts-iron".

User aliases can be created by adding a tool_alias.<TOOL>.versions section to ~/.config/mise/config.toml:

[tool_alias.node.versions]
lts-iron = '20'

Then reference the alias when pinning the tool:

[tools]
node = "lts-iron"

Plugins can also provide aliases via a bin/list-aliases script. Here is an example showing node.js versions:

#!/usr/bin/env bash

echo "lts-krypton 24"
echo "lts-jod 22"
echo "lts-iron 20"

(mise's built-in node plugin already ships these LTS aliases; the example above shows the format that other plugins can use.)

Templates

Alias values can be templates, see Templates for details.

[tool_alias.node.versions]
current = "{{exec(command='node --version')}}"