mise unuse

• Usage: mise unuse [FLAGS] <INSTALLED_TOOL@VERSION>…
• Aliases: rm, remove
• Effect: destructive — may delete or irreversibly overwrite
• Source code: src/cli/unuse.rs

Remove tool requests from config files and prune unused installations

Without --path, --global, or --env, mise edits the first loaded config that declares one of the tools; in your home directory it edits the global config. A version argument matches the configured request literally: to remove node = "20", use mise unuse node@20, not the installed version it resolved to. Omit the version to remove every request for that tool from the selected file.

Versions are pruned only when no remaining tracked config or tool stub needs them. Pass --no-prune to edit the config and keep the installations. To remove an installation without editing config, use mise uninstall.

Arguments

• <INSTALLED_TOOL@VERSION>… — Tools to remove from the config, with the version written as in the config

Flags

• -e --env <ENV> — Edit mise.<ENV>.toml in the current directory, or .mise.<ENV>.toml if that exists

  Not the same as the global -E, which only chooses which config files are loaded.

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

• -p --path <PATH> — Edit this config file, or the config file in this directory

  Aliases: --file

• --no-prune — Do not also prune the installed version

• -h --help — Print help

Examples

Remove node@22.0.0 from mise.toml and uninstall it if nothing else uses it

mise unuse node@22.0.0

Remove it from the global config instead

mise unuse -g node@22.0.0

Remove the node@20 request from mise.staging.toml

mise unuse --env staging node@20

Related documentation

• Removing tools.
• All commands.
• Global flags and argument syntax.