mise uninstall
- Usage:
mise uninstall [FLAGS] [INSTALLED_TOOL@VERSION]… - Effect: destructive — may delete or irreversibly overwrite
- Source code:
src/cli/uninstall.rs
Remove installed tool versions
Removes installed versions but does not edit mise.toml. Use mise unuse to remove a tool from mise.toml and uninstall it. A tool name or version prefix, such as node or node@22, must match exactly one installed version unless you pass --all.
--project removes the installed versions that the project's own config files request. Installs are shared by every project, so other projects that use the same versions have to install them again.
Arguments
[INSTALLED_TOOL@VERSION]…— Tools to remove, such as node@22.0.0
Flags
-a --all— Remove every installed version of the named tools, or of every tool when none is named--project— Remove the installed versions the nearest project config requestsThe project is the nearest directory, starting at the current one and moving up, that has a mise config file. Every config file in that directory counts, such as
mise.toml,mise.local.toml,conf.dfragments,.tool-versionsand idiomatic version files. Configs in parent directories and global or system configs do not. Every version those files name is removed, including one that a later file overrides. Lists what it will remove and asks for confirmation unless--yesor a dry run is given. Tools set to apath:orsystemversion are never removed.-n --dry-run— Show what would change without changing anything--dry-run-code— Like --dry-run, but exit with code 1 if there are tools to uninstallUse it in scripts that check whether tools need uninstalling.
-h --help— Print help
Examples
Uninstall a specific version
mise uninstall node@22.0.0Uninstall node when exactly one version is installed
mise uninstall nodeUninstall every installed version of node
mise uninstall --all nodePreview the versions this project's config requests
mise uninstall --project --dry-run