mise unuse

• Usage: mise unuse [FLAGS] <INSTALLED_TOOL@VERSION>…
• Aliases: rm, remove
• Source code: src/cli/unuse.rs

Removes installed tool versions from mise.toml

By default, this will use the mise.toml file that has the tool defined. If multiple config files exist (e.g., both mise.toml and mise.local.toml), the lowest precedence file (mise.toml) will be used. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations

In the following order:

• If --global is set, it will use the global config file.
• If --path is set, it will use the config file at the given path.
• If --env is set, it will use mise.<env>.toml.
• If MISE_DEFAULT_CONFIG_FILENAME is set, it will use that instead.
• If MISE_OVERRIDE_CONFIG_FILENAMES is set, it will the first from that list.
• Otherwise just "mise.toml" or global config if cwd is home directory.

Will also prune the installed version if no other configurations are using it.

Arguments

<INSTALLED_TOOL@VERSION>…

Tool(s) to remove

Flags

-e --env <ENV>

Create/modify an environment-specific config file like .mise.<env>.toml

-g --global

Use the global config file (~/.config/mise/config.toml) instead of the local one

-p --path <PATH>

Specify a path to a config file or directory

If a directory is specified, it will look for a config file in that directory following the rules above.

--no-prune

Do not also prune the installed version

Examples:

# will uninstall specific version
$ mise unuse node@18.0.0

# will uninstall specific version from global config
$ mise unuse -g node@18.0.0

# will uninstall specific version from .mise.local.toml
$ mise unuse --env local node@20

# will uninstall specific version from .mise.staging.toml
$ mise unuse --env staging node@20