ContextQMD
Back to Mise

`mise bootstrap packages prune`

docs/cli/bootstrap/packages/prune.md

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

mise bootstrap packages prune

  • Usage: mise bootstrap packages prune [FLAGS]
  • Effect: destructive — may delete or irreversibly overwrite
  • Source code: src/cli/system/prune.rs

Prune installed system packages no longer declared in [bootstrap.packages]

Supports Homebrew formulae, conservatively removable mise-owned casks, and packages installed by package plugins that implement PackageUninstall. Pruning keeps packages needed by the current config or by trusted, loadable tracked configs. Plugin packages that were already installed before mise first applied them are never claimed or removed.

Flags

  • -m --manager <MANAGER> — Only prune packages for this manager

    Default: brew

  • -n --dry-run — Print what would be removed without deleting anything

  • -y --yes — Skip the confirmation prompt

  • -h --help — Print help

Examples:

mise bootstrap packages prune --manager brew
mise bootstrap packages prune --manager brew --dry-run
mise bootstrap packages prune --manager brew --yes
mise bootstrap packages prune --manager brew-cask --dry-run
mise bootstrap packages prune --manager vscode --dry-run