ContextQMD
Back to Mise

`mise prune`

docs/cli/prune.md

2026.5.11.2 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

mise prune

Delete unused versions of tools

mise tracks which config files have been used in ~/.local/state/mise/tracked-configs Versions which are no longer the latest specified in any of those configs are deleted. Versions installed only with environment variables MISE_<PLUGIN>_VERSION will be deleted, as will versions only referenced on the command line mise exec <PLUGIN>@<VERSION>.

You can list prunable tools with mise ls --prunable

Arguments

[INSTALLED_TOOL]…

Prune only these tools

Flags

-n --dry-run

Do not actually delete anything

--configs

Prune only tracked and trusted configuration links that point to non-existent configurations

--dry-run-code

Like --dry-run but exits with code 1 if there are tools to prune

This is useful for scripts to check if tools need to be pruned.

--tools

Prune only unused versions of tools

Examples:

$ mise prune --dry-run
rm -rf ~/.local/share/mise/versions/node/20.0.0
rm -rf ~/.local/share/mise/versions/node/20.0.1