MPM-CLEANUP(1) MPM-CLEANUP(1)

mpm cleanup - Cleanup local data.

mpm cleanup [OPTIONS]

Cleanup local data and temporary artifacts.

The work decomposes into cumulative categories, each with a two-sided flag pair: `--orphans/--skip-orphans` (system-wide orphan sweep), `--cache/--skip-cache` (caches, downloads and left-overs) and `--repair/--skip-repair` (local state verification). Positive flags narrow the run to exactly the listed categories; skip flags subtract from the default selection.

A plain `cleanup` runs the cache and repair categories and never removes a package: the orphan sweep is the one destructive category, so it only runs on an explicit `--orphans`, uniformly across managers, just as `remove` keeps its dependency cascade behind the same flag. A manager with no native sweep verb but a native orphan listing gets the sweep synthesized: list the orphans, remove them one by one, and repeat until none are left. Managers supporting none of the selected categories are skipped.

Remove orphaned packages (those nothing depends on anymore) using each manager's system-wide sweep, native or synthesized from its orphan listing. The only category removing packages, so it never runs unless requested.
Prune caches, downloads and other left-over artifacts. The broadest category: for most managers the whole cleanup amounts to it.
Verify and repair the manager's local installation state (like `flatpak repair`).
Show this message and exit.

Remove orphaned packages (those nothing depends on anymore) using each manager's system-wide sweep, native or synthesized from its orphan listing. The only category removing packages, so it never runs unless requested.
Prune caches, downloads and other left-over artifacts. The broadest category: for most managers the whole cleanup amounts to it.
Verify and repair the manager's local installation state (like `flatpak repair`).
Show this message and exit.

0
Success.
1
A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

Prune caches and repair local state

mpm cleanup

Also remove the packages nothing requires

mpm cleanup \-\-orphans

Prune caches and nothing else

mpm cleanup \-\-skip\-repair
2026-09-28