MPM(1) MPM(1)

mpm - CLI options shared by all subcommands.

mpm [OPTIONS] COMMAND [ARGS]...

CLI options shared by all subcommands.

Use these options to restrict the subcommand to a subset of managers.

- By default, mpm will evaluate all managers supported on the current platform.
- Use the --<manager-id> selectors to restrict target to a subset of managers.
- To remove a manager from the selection, use --no-<manager-id> selectors.
- Order of the selectors is preserved for priority-sensitive subcommands.
- Exclusion of a manager always takes precedence over its inclusion.
?
Select Alpine apk.
Select Atom apm. (DEPRECATED)
Select Debian apt.
Select Linux Mint apt.
Select asdf.
Select Homebrew Formulae.
Select Rust cargo.
Select Homebrew Cask.
Select Chocolatey.
Select PHP Composer.
Select Perl CPAN.
Select deb-get.
Select Fedora DNF.
Select Fedora DNF5.
Select Gentoo emerge.
Select Solus eopkg.
Select Flatpak.
Select Linux fwupd.
Select RubyGems.
Select GNU Guix.
Select MacPorts.
Select Mac App Store.
Select mise.
Select Nix.
Select Node npm.
Select opkg.
Select Arch Linux pacaur.
Select Arch Linux pacman.
Select Pacstall.
Select Arch Linux paru.
Select Python pip.
Select Python pipx.
Select FreeBSD pkg.
Select FreeBSD Ports Collection.
Select PowerShell Gallery.
Select Scoop.
Select SDKMAN.
Select Scoop sfsu.
Select Snap.
Select Valve SteamCMD.
Select stew.
Select Topgrade.
Select Python uv.
Select Python uvx.
Select Visual Studio Code.
Select VSCodium.
Select WinGet.
Select Void XBPS.
Select Yarn Berry.
Select Yarn Classic.
Select Arch Linux yay.
Select Fedora YUM.
Select zerobrew.
Select openSUSE Zypper.
Deselect Alpine apk.
Deselect Atom apm. (DEPRECATED)
Deselect Debian apt.
Deselect Linux Mint apt.
Deselect asdf.
Deselect Homebrew Formulae.
Deselect Rust cargo.
Deselect Homebrew Cask.
Deselect Chocolatey.
Deselect PHP Composer.
Deselect Perl CPAN.
Deselect deb-get.
Deselect Fedora DNF.
Deselect Fedora DNF5.
Deselect Gentoo emerge.
Deselect Solus eopkg.
Deselect Flatpak.
Deselect Linux fwupd.
Deselect RubyGems.
Deselect GNU Guix.
Deselect MacPorts.
Deselect Mac App Store.
Deselect mise.
Deselect Nix.
Deselect Node npm.
Deselect opkg.
Deselect Arch Linux pacaur.
Deselect Arch Linux pacman.
Deselect Pacstall.
Deselect Arch Linux paru.
Deselect Python pip.
Deselect Python pipx.
Deselect FreeBSD pkg.
Deselect FreeBSD Ports Collection.
Deselect PowerShell Gallery.
Deselect Scoop.
Deselect SDKMAN.
Deselect Scoop sfsu.
Deselect Snap.
Deselect Valve SteamCMD.
Deselect stew.
Deselect Topgrade.
Deselect Python uv.
Deselect Python uvx.
Deselect Visual Studio Code.
Deselect VSCodium.
Deselect WinGet.
Deselect Void XBPS.
Deselect Yarn Berry.
Deselect Yarn Classic.
Deselect Arch Linux yay.
Deselect Fedora YUM.
Deselect zerobrew.
Deselect openSUSE Zypper.
Force evaluation of all managers implemented by mpm, including those not supported by the current platform or deprecated. Still applies filtering by --<manager-id> / --no-<manager-id> options before calling the subcommand.
Preset manager selection as defined by XKCD #1654. Equivalent to: --pip --brew --npm --dnf --apt --steamcmd.

Report all outdated packages, including those tagged as auto-updating. Only applies to outdated and upgrade subcommands.
Stop right away or continue operations on manager CLI error.
Do not actually perform any action, just simulate CLI calls.
Maximum duration in seconds for each CLI call. Applies to every manager and operation. When unset, a per-operation default is used instead: a short cap for read-only queries (installed, outdated, search) and a longer one for state-changing operations (install, upgrade, remove, sync, cleanup).
Refuse to install or upgrade any package version published more recently than this duration, as a mitigation against supply-chain attacks. Accepts a friendly duration ('7 days', '1 week', '12h'), an ISO 8601 duration ('P7D', 'PT12H'), or an RFC 3339 absolute timestamp ('2024-05-01T00:00:00Z'). Only honored by managers with native release-age support (uv, npm, pip, pipx); the others are skipped unless --allow-unsupported-managers is set.
When --cooldown is set, whether to require each manager to natively enforce it. The default (--require-cooldown-support) skips managers that cannot, so nothing slips in unguarded (fail-closed). --allow-unsupported-managers runs install and upgrade on them anyway, trading the supply-chain safeguard for broader manager coverage.

Show package description in results.
Sort results.
Print an end-of-run summary on stderr: a count line of per-manager totals plus any subcommand-specific follow-up notes (like SBOM enrichment and merge counts). Defaults on; use --no-summary to silence.
Print a contribution invitation when a user override targets a field that likely indicates an upstream detection bug (cli_names, cli_search_path, requirement, version_cli_options, version_regexes).

Print location of the Xbar/SwiftBar plugin.

Measure and print elapsed execution time.
Location of the configuration file. Supports local path with glob patterns or remote URL.
Ignore all configuration files and only use command line parameters and environment variables.
Validate the configuration file and exit.
Accessibility mode: disable colors and render tables in a plain, screen-reader-friendly format.
Strip out all colors and all ANSI codes from output.
Show a progress spinner during long operations. Disabled for non-interactive output (pipes, dumb terminals, CI) and by --accessible.
Color theme used for help screens.
Show all CLI parameters, their provenance, defaults and value, then exit.
Rendering style of tables.
Either CRITICAL, ERROR, WARNING, INFO, DEBUG.
Show the command's man page (roff) and exit.
Show the version and exit.
Show this message and exit.

Cleanup local data.
Print per-manager overrides as a TOML config template.
Snapshot installed packages to a TOML manifest or a Brewfile.
Show help for a command.
Install a package.
List installed packages.
List every registered package manager and check its presence on the system.
List outdated packages.
Remove a package.
Install packages referenced in TOML files.
Export installed packages to a SBOM document.
Search packages.
Sync local package info.
Upgrade packages.
Locate CLIs on system.

Select Alpine apk.
Select Atom apm. (DEPRECATED)
Select Debian apt.
Select Linux Mint apt.
Select asdf.
Select Homebrew Formulae.
Select Rust cargo.
Select Homebrew Cask.
Select Chocolatey.
Select PHP Composer.
Select Perl CPAN.
Select deb-get.
Select Fedora DNF.
Select Fedora DNF5.
Select Gentoo emerge.
Select Solus eopkg.
Select Flatpak.
Select Linux fwupd.
Select RubyGems.
Select GNU Guix.
Select MacPorts.
Select Mac App Store.
Select mise.
Select Nix.
Select Node npm.
Select opkg.
Select Arch Linux pacaur.
Select Arch Linux pacman.
Select Pacstall.
Select Arch Linux paru.
Select Python pip.
Select Python pipx.
Select FreeBSD pkg.
Select FreeBSD Ports Collection.
Select PowerShell Gallery.
Select Scoop.
Select SDKMAN.
Select Scoop sfsu.
Select Snap.
Select Valve SteamCMD.
Select stew.
Select Topgrade.
Select Python uv.
Select Python uvx.
Select Visual Studio Code.
Select VSCodium.
Select WinGet.
Select Void XBPS.
Select Yarn Berry.
Select Yarn Classic.
Select Arch Linux yay.
Select Fedora YUM.
Select zerobrew.
Select openSUSE Zypper.
Deselect Alpine apk.
Deselect Atom apm. (DEPRECATED)
Deselect Debian apt.
Deselect Linux Mint apt.
Deselect asdf.
Deselect Homebrew Formulae.
Deselect Rust cargo.
Deselect Homebrew Cask.
Deselect Chocolatey.
Deselect PHP Composer.
Deselect Perl CPAN.
Deselect deb-get.
Deselect Fedora DNF.
Deselect Fedora DNF5.
Deselect Gentoo emerge.
Deselect Solus eopkg.
Deselect Flatpak.
Deselect Linux fwupd.
Deselect RubyGems.
Deselect GNU Guix.
Deselect MacPorts.
Deselect Mac App Store.
Deselect mise.
Deselect Nix.
Deselect Node npm.
Deselect opkg.
Deselect Arch Linux pacaur.
Deselect Arch Linux pacman.
Deselect Pacstall.
Deselect Arch Linux paru.
Deselect Python pip.
Deselect Python pipx.
Deselect FreeBSD pkg.
Deselect FreeBSD Ports Collection.
Deselect PowerShell Gallery.
Deselect Scoop.
Deselect SDKMAN.
Deselect Scoop sfsu.
Deselect Snap.
Deselect Valve SteamCMD.
Deselect stew.
Deselect Topgrade.
Deselect Python uv.
Deselect Python uvx.
Deselect Visual Studio Code.
Deselect VSCodium.
Deselect WinGet.
Deselect Void XBPS.
Deselect Yarn Berry.
Deselect Yarn Classic.
Deselect Arch Linux yay.
Deselect Fedora YUM.
Deselect zerobrew.
Deselect openSUSE Zypper.
Force evaluation of all managers implemented by mpm, including those not supported by the current platform or deprecated. Still applies filtering by --<manager-id> / --no-<manager-id> options before calling the subcommand.
Preset manager selection as defined by XKCD #1654. Equivalent to: --pip --brew --npm --dnf --apt --steamcmd.
Report all outdated packages, including those tagged as auto-updating. Only applies to outdated and upgrade subcommands.
Stop right away or continue operations on manager CLI error.
Do not actually perform any action, just simulate CLI calls.
Maximum duration in seconds for each CLI call. Applies to every manager and operation. When unset, a per-operation default is used instead: a short cap for read-only queries (installed, outdated, search) and a longer one for state-changing operations (install, upgrade, remove, sync, cleanup).
Refuse to install or upgrade any package version published more recently than this duration, as a mitigation against supply-chain attacks. Accepts a friendly duration ('7 days', '1 week', '12h'), an ISO 8601 duration ('P7D', 'PT12H'), or an RFC 3339 absolute timestamp ('2024-05-01T00:00:00Z'). Only honored by managers with native release-age support (uv, npm, pip, pipx); the others are skipped unless --allow-unsupported-managers is set.
When --cooldown is set, whether to require each manager to natively enforce it. The default (--require-cooldown-support) skips managers that cannot, so nothing slips in unguarded (fail-closed). --allow-unsupported-managers runs install and upgrade on them anyway, trading the supply-chain safeguard for broader manager coverage.
Show package description in results.
Sort results.
Print an end-of-run summary on stderr: a count line of per-manager totals plus any subcommand-specific follow-up notes (like SBOM enrichment and merge counts). Defaults on; use --no-summary to silence.
Print a contribution invitation when a user override targets a field that likely indicates an upstream detection bug (cli_names, cli_search_path, requirement, version_cli_options, version_regexes).
Print location of the Xbar/SwiftBar plugin.
Measure and print elapsed execution time.
Location of the configuration file. Supports local path with glob patterns or remote URL.
Validate the configuration file and exit.
Accessibility mode: disable colors and render tables in a plain, screen-reader-friendly format.
Strip out all colors and all ANSI codes from output.
Show a progress spinner during long operations. Disabled for non-interactive output (pipes, dumb terminals, CI) and by --accessible.
Color theme used for help screens.
Show all CLI parameters, their provenance, defaults and value, then exit.
Rendering style of tables.
Either CRITICAL, ERROR, WARNING, INFO, DEBUG.
Show the command's man page (roff) and exit.
Show the version and exit.
Show this message and exit.

~/.config/mpm/{*.toml,*.yaml,*.yml,*.json,*.json5,*.jsonc,*.hjson,*.ini,*.xml,pyproject.toml}

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.
2026-06-19