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 Homebrew Cask.
Select Chocolatey.
Select PHP Composer.
Select Conda.
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 Arch Linux pacaur.
Select Arch Linux pacman.
Select Pacstall.
Select Arch Linux paru.
Select Python pip.
Select Python pipx.
Select PackageKit.
Select FreeBSD pkg.
Select Node pnpm.
Select FreeBSD Ports Collection.
Select PowerShell Gallery.
Select Scoop.
Select SDKMAN.
Select Scoop sfsu.
Select Snap.
Select stew.
Select Solaris SVR4 package tools.
Select TazPkg.
Select Python uv.
Select Python uvx.
Select WinGet.
Select Void XBPS.
Select Yarn Berry.
Select Yarn Classic.
Select Arch Linux yay.
Select Fedora YUM.
Select zerobrew.
Select openSUSE Zypper.
Select apt-cyg.
Select Rust cargo.
Select cave.
Select Chromebrew.
Select Perl CPAN.
Select Fink.
Select GitHub CLI extensions.
Select opkg.
Select OpenBSD pkg tools.
Select Pkgin.
Select slapt-get.
Select Soar.
Select Sorcery.
Select Valve SteamCMD.
Select Clear Linux Software Updater.
Select TeX Live Manager.
Select Topgrade.
Select urpmi.
Select Visual Studio Code.
Select VSCodium.
Deselect Alpine apk.
Deselect Atom apm. (DEPRECATED)
Deselect Debian apt.
Deselect Linux Mint apt.
Deselect asdf.
Deselect Homebrew Formulae.
Deselect Homebrew Cask.
Deselect Chocolatey.
Deselect PHP Composer.
Deselect Conda.
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 Arch Linux pacaur.
Deselect Arch Linux pacman.
Deselect Pacstall.
Deselect Arch Linux paru.
Deselect Python pip.
Deselect Python pipx.
Deselect PackageKit.
Deselect FreeBSD pkg.
Deselect Node pnpm.
Deselect FreeBSD Ports Collection.
Deselect PowerShell Gallery.
Deselect Scoop.
Deselect SDKMAN.
Deselect Scoop sfsu.
Deselect Snap.
Deselect stew.
Deselect Solaris SVR4 package tools.
Deselect TazPkg.
Deselect Python uv.
Deselect Python uvx.
Deselect WinGet.
Deselect Void XBPS.
Deselect Yarn Berry.
Deselect Yarn Classic.
Deselect Arch Linux yay.
Deselect Fedora YUM.
Deselect zerobrew.
Deselect openSUSE Zypper.
Deselect apt-cyg.
Deselect Rust cargo.
Deselect cave.
Deselect Chromebrew.
Deselect Perl CPAN.
Deselect Fink.
Deselect GitHub CLI extensions.
Deselect opkg.
Deselect OpenBSD pkg tools.
Deselect Pkgin.
Deselect slapt-get.
Deselect Soar.
Deselect Sorcery.
Deselect Valve SteamCMD.
Deselect Clear Linux Software Updater.
Deselect TeX Live Manager.
Deselect Topgrade.
Deselect urpmi.
Deselect Visual Studio Code.
Deselect VSCodium.
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.
Force running privileged manager operations with (or without) sudo. Unset by default, letting each manager decide: system managers (apt, dnf, pacman, ...) escalate, user-level managers do not. When escalation is needed on a terminal, mpm authenticates once up front instead of prompting mid-run; off a terminal, managers needing root fail fast rather than stalling.
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 (npm, pip, pipx, pnpm, uv, uvx, yay); 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.
Maximum number of managers to run concurrently. Defaults to one less than the CPU count; set 1 to run sequentially. Applies to read-only queries (installed, outdated, search), maintenance commands (sync, cleanup, upgrade --all), and the state changers (install, remove, upgrade, restore), which fan out across managers while running each manager's own packages one at a time. Installing a package left untied to a manager stays sequential.

Show package description in results. Shorthand for adding the 'description' column to 'mpm search'; an explicit --columns selection wins.
Sort results by this field. Repeat to add tie-breakers in priority order, like '-s manager_id -s package_id'.
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.
Opt into network calls during the run. Today this only affects 'mpm sbom', which uses the flag to query OSV.dev for vulnerability data and attach it to the rendered document. Responses are cached on disk so repeat runs are fast. Defaults off; the offline path remains the default. Note: when enabled, this transmits the package inventory to the queried services.
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.
Export the configuration in the selected format to <stdout>, then exit.
Accessibility mode: disable colors and render tables in a plain, screen-reader-friendly format.
Colorize the output. A bare --color is the same as --color=always.
Disable colorization (alias of --color=never).
Show progress indicators 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.
-0 / --zero-exit
Always exit with a status code of 0, even when problems are found.
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 Homebrew Cask.
Select Chocolatey.
Select PHP Composer.
Select Conda.
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 Arch Linux pacaur.
Select Arch Linux pacman.
Select Pacstall.
Select Arch Linux paru.
Select Python pip.
Select Python pipx.
Select PackageKit.
Select FreeBSD pkg.
Select Node pnpm.
Select FreeBSD Ports Collection.
Select PowerShell Gallery.
Select Scoop.
Select SDKMAN.
Select Scoop sfsu.
Select Snap.
Select stew.
Select Solaris SVR4 package tools.
Select TazPkg.
Select Python uv.
Select Python uvx.
Select WinGet.
Select Void XBPS.
Select Yarn Berry.
Select Yarn Classic.
Select Arch Linux yay.
Select Fedora YUM.
Select zerobrew.
Select openSUSE Zypper.
Select apt-cyg.
Select Rust cargo.
Select cave.
Select Chromebrew.
Select Perl CPAN.
Select Fink.
Select GitHub CLI extensions.
Select opkg.
Select OpenBSD pkg tools.
Select Pkgin.
Select slapt-get.
Select Soar.
Select Sorcery.
Select Valve SteamCMD.
Select Clear Linux Software Updater.
Select TeX Live Manager.
Select Topgrade.
Select urpmi.
Select Visual Studio Code.
Select VSCodium.
Deselect Alpine apk.
Deselect Atom apm. (DEPRECATED)
Deselect Debian apt.
Deselect Linux Mint apt.
Deselect asdf.
Deselect Homebrew Formulae.
Deselect Homebrew Cask.
Deselect Chocolatey.
Deselect PHP Composer.
Deselect Conda.
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 Arch Linux pacaur.
Deselect Arch Linux pacman.
Deselect Pacstall.
Deselect Arch Linux paru.
Deselect Python pip.
Deselect Python pipx.
Deselect PackageKit.
Deselect FreeBSD pkg.
Deselect Node pnpm.
Deselect FreeBSD Ports Collection.
Deselect PowerShell Gallery.
Deselect Scoop.
Deselect SDKMAN.
Deselect Scoop sfsu.
Deselect Snap.
Deselect stew.
Deselect Solaris SVR4 package tools.
Deselect TazPkg.
Deselect Python uv.
Deselect Python uvx.
Deselect WinGet.
Deselect Void XBPS.
Deselect Yarn Berry.
Deselect Yarn Classic.
Deselect Arch Linux yay.
Deselect Fedora YUM.
Deselect zerobrew.
Deselect openSUSE Zypper.
Deselect apt-cyg.
Deselect Rust cargo.
Deselect cave.
Deselect Chromebrew.
Deselect Perl CPAN.
Deselect Fink.
Deselect GitHub CLI extensions.
Deselect opkg.
Deselect OpenBSD pkg tools.
Deselect Pkgin.
Deselect slapt-get.
Deselect Soar.
Deselect Sorcery.
Deselect Valve SteamCMD.
Deselect Clear Linux Software Updater.
Deselect TeX Live Manager.
Deselect Topgrade.
Deselect urpmi.
Deselect Visual Studio Code.
Deselect VSCodium.
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.
Force running privileged manager operations with (or without) sudo. Unset by default, letting each manager decide: system managers (apt, dnf, pacman, ...) escalate, user-level managers do not. When escalation is needed on a terminal, mpm authenticates once up front instead of prompting mid-run; off a terminal, managers needing root fail fast rather than stalling.
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 (npm, pip, pipx, pnpm, uv, uvx, yay); 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. Shorthand for adding the 'description' column to 'mpm search'; an explicit --columns selection wins.
Sort results by this field. Repeat to add tie-breakers in priority order, like '-s manager_id -s package_id'.
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.
Opt into network calls during the run. Today this only affects 'mpm sbom', which uses the flag to query OSV.dev for vulnerability data and attach it to the rendered document. Responses are cached on disk so repeat runs are fast. Defaults off; the offline path remains the default. Note: when enabled, this transmits the package inventory to the queried services.
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.
Export the configuration in the selected format to <stdout>, then exit.
Accessibility mode: disable colors and render tables in a plain, screen-reader-friendly format.
Colorize the output. A bare --color is the same as --color=always.
Disable colorization (alias of --color=never).
Show progress indicators 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.
Always exit with a status code of 0, even when problems are found.
Maximum number of managers to run concurrently. Defaults to one less than the CPU count; set 1 to run sequentially. Applies to read-only queries (installed, outdated, search), maintenance commands (sync, cleanup, upgrade --all), and the state changers (install, remove, upgrade, restore), which fan out across managers while running each manager's own packages one at a time. Installing a package left untied to a manager stays sequential.
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-07-09