CLI parametersΒΆ
Help screenΒΆ
OptionsΒΆ
mpmΒΆ
CLI options shared by all subcommands.
Usage
mpm [OPTIONS] COMMAND [ARGS]...
Options
- --apkΒΆ
Select Alpine apk.
- --apmΒΆ
Select Atom apm. (DEPRECATED)
- --aptΒΆ
Select Debian apt.
- --apt-mintΒΆ
Select Linux Mint apt.
- --asdfΒΆ
Select asdf.
- --brewΒΆ
Select Homebrew Formulae.
- --cargoΒΆ
Select Rust cargo.
- --caskΒΆ
Select Homebrew Cask.
- --chocoΒΆ
Select Chocolatey.
- --composerΒΆ
Select PHP Composer.
- --cpanΒΆ
Select Perl CPAN.
- --deb-getΒΆ
Select deb-get.
- --dnfΒΆ
Select Fedora DNF.
- --dnf5ΒΆ
Select Fedora DNF5.
- --emergeΒΆ
Select Gentoo emerge.
- --eopkgΒΆ
Select Solus eopkg.
- --flatpakΒΆ
Select Flatpak.
- --fwupdΒΆ
Select Linux fwupd.
- --gemΒΆ
Select RubyGems.
- --guixΒΆ
Select GNU Guix.
- --macportsΒΆ
Select MacPorts.
- --masΒΆ
Select Mac App Store.
- --miseΒΆ
Select mise.
- --nixΒΆ
Select Nix.
- --npmΒΆ
Select Node npm.
- --opkgΒΆ
Select opkg.
- --pacaurΒΆ
Select Arch Linux pacaur.
- --pacmanΒΆ
Select Arch Linux pacman.
- --pacstallΒΆ
Select Pacstall.
- --paruΒΆ
Select Arch Linux paru.
- --pipΒΆ
Select Python pip.
- --pipxΒΆ
Select Python pipx.
- --pkgΒΆ
Select FreeBSD pkg.
- --portsΒΆ
Select FreeBSD Ports Collection.
- --pwsh-galleryΒΆ
Select PowerShell Gallery.
- --scoopΒΆ
Select Scoop.
- --sdkmanΒΆ
Select SDKMAN.
- --sfsuΒΆ
Select Scoop sfsu.
- --snapΒΆ
Select Snap.
- --steamcmdΒΆ
Select Valve SteamCMD.
- --stewΒΆ
Select stew.
- --topgradeΒΆ
Select Topgrade.
- --uvΒΆ
Select Python uv.
- --uvxΒΆ
Select Python uvx.
- --vscodeΒΆ
Select Visual Studio Code.
- --vscodiumΒΆ
Select VSCodium.
- --wingetΒΆ
Select WinGet.
- --xbpsΒΆ
Select Void XBPS.
- --yarn-berryΒΆ
Select Yarn Berry.
- --yarnΒΆ
Select Yarn Classic.
- --yayΒΆ
Select Arch Linux yay.
- --yumΒΆ
Select Fedora YUM.
- --zerobrewΒΆ
Select zerobrew.
- --zypperΒΆ
Select openSUSE Zypper.
- --no-apkΒΆ
Deselect Alpine apk.
- --no-apmΒΆ
Deselect Atom apm. (DEPRECATED)
- --no-aptΒΆ
Deselect Debian apt.
- --no-apt-mintΒΆ
Deselect Linux Mint apt.
- --no-asdfΒΆ
Deselect asdf.
- --no-brewΒΆ
Deselect Homebrew Formulae.
- --no-cargoΒΆ
Deselect Rust cargo.
- --no-caskΒΆ
Deselect Homebrew Cask.
- --no-chocoΒΆ
Deselect Chocolatey.
- --no-composerΒΆ
Deselect PHP Composer.
- --no-cpanΒΆ
Deselect Perl CPAN.
- --no-deb-getΒΆ
Deselect deb-get.
- --no-dnfΒΆ
Deselect Fedora DNF.
- --no-dnf5ΒΆ
Deselect Fedora DNF5.
- --no-emergeΒΆ
Deselect Gentoo emerge.
- --no-eopkgΒΆ
Deselect Solus eopkg.
- --no-flatpakΒΆ
Deselect Flatpak.
- --no-fwupdΒΆ
Deselect Linux fwupd.
- --no-gemΒΆ
Deselect RubyGems.
- --no-guixΒΆ
Deselect GNU Guix.
- --no-macportsΒΆ
Deselect MacPorts.
- --no-masΒΆ
Deselect Mac App Store.
- --no-miseΒΆ
Deselect mise.
- --no-nixΒΆ
Deselect Nix.
- --no-npmΒΆ
Deselect Node npm.
- --no-opkgΒΆ
Deselect opkg.
- --no-pacaurΒΆ
Deselect Arch Linux pacaur.
- --no-pacmanΒΆ
Deselect Arch Linux pacman.
- --no-pacstallΒΆ
Deselect Pacstall.
- --no-paruΒΆ
Deselect Arch Linux paru.
- --no-pipΒΆ
Deselect Python pip.
- --no-pipxΒΆ
Deselect Python pipx.
- --no-pkgΒΆ
Deselect FreeBSD pkg.
- --no-portsΒΆ
Deselect FreeBSD Ports Collection.
- --no-pwsh-galleryΒΆ
Deselect PowerShell Gallery.
- --no-scoopΒΆ
Deselect Scoop.
- --no-sdkmanΒΆ
Deselect SDKMAN.
- --no-sfsuΒΆ
Deselect Scoop sfsu.
- --no-snapΒΆ
Deselect Snap.
- --no-steamcmdΒΆ
Deselect Valve SteamCMD.
- --no-stewΒΆ
Deselect stew.
- --no-topgradeΒΆ
Deselect Topgrade.
- --no-uvΒΆ
Deselect Python uv.
- --no-uvxΒΆ
Deselect Python uvx.
- --no-vscodeΒΆ
Deselect Visual Studio Code.
- --no-vscodiumΒΆ
Deselect VSCodium.
- --no-wingetΒΆ
Deselect WinGet.
- --no-xbpsΒΆ
Deselect Void XBPS.
- --no-yarn-berryΒΆ
Deselect Yarn Berry.
- --no-yarnΒΆ
Deselect Yarn Classic.
- --no-yayΒΆ
Deselect Arch Linux yay.
- --no-yumΒΆ
Deselect Fedora YUM.
- --no-zerobrewΒΆ
Deselect zerobrew.
- --no-zypperΒΆ
Deselect openSUSE Zypper.
- -a, --all-managersΒΆ
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.
- -x, --xkcdΒΆ
Preset manager selection as defined by XKCD #1654. Equivalent to: βpip βbrew βnpm βdnf βapt βsteamcmd.
- --ignore-auto-updates, --include-auto-updatesΒΆ
Report all outdated packages, including those tagged as auto-updating. Only applies to outdated and upgrade subcommands.
- --stop-on-error, --continue-on-errorΒΆ
Stop right away or continue operations on manager CLI error.
- -d, --dry-runΒΆ
Do not actually perform any action, just simulate CLI calls.
- -t, --timeout <timeout>ΒΆ
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).
- --cooldown <DURATION>ΒΆ
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.
- --require-cooldown-support, --allow-unsupported-managersΒΆ
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.
- --descriptionΒΆ
Show package description in results.
- -s, --sort-by <sort_by>ΒΆ
Sort results.
- Options:
manager_id | manager_name | package_id | package_name | version
- --summary, --no-summaryΒΆ
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.
- --suggest-contribs, --no-suggest-contribsΒΆ
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).
- --bar-plugin-pathΒΆ
Print location of the Xbar/SwiftBar plugin.
- --time, --no-timeΒΆ
Measure and print elapsed execution time.
- --config <CONFIG_PATH>ΒΆ
Location of the configuration file. Supports local path with glob patterns or remote URL.
- --no-configΒΆ
Ignore all configuration files and only use command line parameters and environment variables.
- --validate-config <validate_config>ΒΆ
Validate the configuration file and exit.
- --accessibleΒΆ
Accessibility mode: disable colors and render tables in a plain, screen-reader-friendly format.
- --color, --ansi, --no-color, --no-ansiΒΆ
Strip out all colors and all ANSI codes from output.
- --theme <theme>ΒΆ
Color theme used for help screens.
- --show-paramsΒΆ
Show all CLI parameters, their provenance, defaults and value, then exit.
- --table-format <table_format>ΒΆ
Rendering style of tables.
- Options:
aligned | asciidoc | colon-grid | csv | csv-excel | csv-excel-tab | csv-unix | double-grid | double-outline | fancy-grid | fancy-outline | github | grid | heavy-grid | heavy-outline | hjson | html | jira | json | json5 | jsonc | latex | latex-booktabs | latex-longtable | latex-raw | mediawiki | mixed-grid | mixed-outline | moinmoin | orgtbl | outline | pipe | plain | presto | pretty | psql | rounded-grid | rounded-outline | rst | simple | simple-grid | simple-outline | textile | toml | tsv | unsafehtml | vertical | xml | yaml | youtrack
- --verbosity <LEVEL>ΒΆ
Either CRITICAL, ERROR, WARNING, INFO, DEBUG.
- Options:
CRITICAL | ERROR | WARNING | INFO | DEBUG
- -v, --verboseΒΆ
- --manΒΆ
Show the commandβs man page (roff) and exit.
- --versionΒΆ
Show the version and exit.
Environment variables
- ('MPM_APK',)
Provide a default for
--apk
- ('MPM_APM',)
Provide a default for
--apm
- ('MPM_APT',)
Provide a default for
--apt
- ('MPM_APT_MINT',)
Provide a default for
--apt-mint
- ('MPM_ASDF',)
Provide a default for
--asdf
- ('MPM_BREW',)
Provide a default for
--brew
- ('MPM_CARGO',)
Provide a default for
--cargo
- ('MPM_CASK',)
Provide a default for
--cask
- ('MPM_CHOCO',)
Provide a default for
--choco
- ('MPM_COMPOSER',)
Provide a default for
--composer
- ('MPM_CPAN',)
Provide a default for
--cpan
- ('MPM_DEB_GET',)
Provide a default for
--deb-get
- ('MPM_DNF',)
Provide a default for
--dnf
- ('MPM_DNF5',)
Provide a default for
--dnf5
- ('MPM_EMERGE',)
Provide a default for
--emerge
- ('MPM_EOPKG',)
Provide a default for
--eopkg
- ('MPM_FLATPAK',)
Provide a default for
--flatpak
- ('MPM_FWUPD',)
Provide a default for
--fwupd
- ('MPM_GEM',)
Provide a default for
--gem
- ('MPM_GUIX',)
Provide a default for
--guix
- ('MPM_MACPORTS',)
Provide a default for
--macports
- ('MPM_MAS',)
Provide a default for
--mas
- ('MPM_MISE',)
Provide a default for
--mise
- ('MPM_NIX',)
Provide a default for
--nix
- ('MPM_NPM',)
Provide a default for
--npm
- ('MPM_OPKG',)
Provide a default for
--opkg
- ('MPM_PACAUR',)
Provide a default for
--pacaur
- ('MPM_PACMAN',)
Provide a default for
--pacman
- ('MPM_PACSTALL',)
Provide a default for
--pacstall
- ('MPM_PARU',)
Provide a default for
--paru
- ('MPM_PIP',)
Provide a default for
--pip
- ('MPM_PIPX',)
Provide a default for
--pipx
- ('MPM_PKG',)
Provide a default for
--pkg
- ('MPM_PORTS',)
Provide a default for
--ports
- ('MPM_PWSH_GALLERY',)
Provide a default for
--pwsh-gallery
- ('MPM_SCOOP',)
Provide a default for
--scoop
- ('MPM_SDKMAN',)
Provide a default for
--sdkman
- ('MPM_SFSU',)
Provide a default for
--sfsu
- ('MPM_SNAP',)
Provide a default for
--snap
- ('MPM_STEAMCMD',)
Provide a default for
--steamcmd
- ('MPM_STEW',)
Provide a default for
--stew
- ('MPM_TOPGRADE',)
Provide a default for
--topgrade
- ('MPM_UV',)
Provide a default for
--uv
- ('MPM_UVX',)
Provide a default for
--uvx
- ('MPM_VSCODE',)
Provide a default for
--vscode
- ('MPM_VSCODIUM',)
Provide a default for
--vscodium
- ('MPM_WINGET',)
Provide a default for
--winget
- ('MPM_XBPS',)
Provide a default for
--xbps
- ('MPM_YARN_BERRY',)
Provide a default for
--yarn-berry
- ('MPM_YARN',)
Provide a default for
--yarn
- ('MPM_YAY',)
Provide a default for
--yay
- ('MPM_YUM',)
Provide a default for
--yum
- ('MPM_ZEROBREW',)
Provide a default for
--zerobrew
- ('MPM_ZYPPER',)
Provide a default for
--zypper
- ('MPM_NO_APK',)
Provide a default for
--no-apk
- ('MPM_NO_APM',)
Provide a default for
--no-apm
- ('MPM_NO_APT',)
Provide a default for
--no-apt
- ('MPM_NO_APT_MINT',)
Provide a default for
--no-apt-mint
- ('MPM_NO_ASDF',)
Provide a default for
--no-asdf
- ('MPM_NO_BREW',)
Provide a default for
--no-brew
- ('MPM_NO_CARGO',)
Provide a default for
--no-cargo
- ('MPM_NO_CASK',)
Provide a default for
--no-cask
- ('MPM_NO_CHOCO',)
Provide a default for
--no-choco
- ('MPM_NO_COMPOSER',)
Provide a default for
--no-composer
- ('MPM_NO_CPAN',)
Provide a default for
--no-cpan
- ('MPM_NO_DEB_GET',)
Provide a default for
--no-deb-get
- ('MPM_NO_DNF',)
Provide a default for
--no-dnf
- ('MPM_NO_DNF5',)
Provide a default for
--no-dnf5
- ('MPM_NO_EMERGE',)
Provide a default for
--no-emerge
- ('MPM_NO_EOPKG',)
Provide a default for
--no-eopkg
- ('MPM_NO_FLATPAK',)
Provide a default for
--no-flatpak
- ('MPM_NO_FWUPD',)
Provide a default for
--no-fwupd
- ('MPM_NO_GEM',)
Provide a default for
--no-gem
- ('MPM_NO_GUIX',)
Provide a default for
--no-guix
- ('MPM_NO_MACPORTS',)
Provide a default for
--no-macports
- ('MPM_NO_MAS',)
Provide a default for
--no-mas
- ('MPM_NO_MISE',)
Provide a default for
--no-mise
- ('MPM_NO_NIX',)
Provide a default for
--no-nix
- ('MPM_NO_NPM',)
Provide a default for
--no-npm
- ('MPM_NO_OPKG',)
Provide a default for
--no-opkg
- ('MPM_NO_PACAUR',)
Provide a default for
--no-pacaur
- ('MPM_NO_PACMAN',)
Provide a default for
--no-pacman
- ('MPM_NO_PACSTALL',)
Provide a default for
--no-pacstall
- ('MPM_NO_PARU',)
Provide a default for
--no-paru
- ('MPM_NO_PIP',)
Provide a default for
--no-pip
- ('MPM_NO_PIPX',)
Provide a default for
--no-pipx
- ('MPM_NO_PKG',)
Provide a default for
--no-pkg
- ('MPM_NO_PORTS',)
Provide a default for
--no-ports
- ('MPM_NO_PWSH_GALLERY',)
Provide a default for
--no-pwsh-gallery
- ('MPM_NO_SCOOP',)
Provide a default for
--no-scoop
- ('MPM_NO_SDKMAN',)
Provide a default for
--no-sdkman
- ('MPM_NO_SFSU',)
Provide a default for
--no-sfsu
- ('MPM_NO_SNAP',)
Provide a default for
--no-snap
- ('MPM_NO_STEAMCMD',)
Provide a default for
--no-steamcmd
- ('MPM_NO_STEW',)
Provide a default for
--no-stew
- ('MPM_NO_TOPGRADE',)
Provide a default for
--no-topgrade
- ('MPM_NO_UV',)
Provide a default for
--no-uv
- ('MPM_NO_UVX',)
Provide a default for
--no-uvx
- ('MPM_NO_VSCODE',)
Provide a default for
--no-vscode
- ('MPM_NO_VSCODIUM',)
Provide a default for
--no-vscodium
- ('MPM_NO_WINGET',)
Provide a default for
--no-winget
- ('MPM_NO_XBPS',)
Provide a default for
--no-xbps
- ('MPM_NO_YARN_BERRY',)
Provide a default for
--no-yarn-berry
- ('MPM_NO_YARN',)
Provide a default for
--no-yarn
- ('MPM_NO_YAY',)
Provide a default for
--no-yay
- ('MPM_NO_YUM',)
Provide a default for
--no-yum
- ('MPM_NO_ZEROBREW',)
Provide a default for
--no-zerobrew
- ('MPM_NO_ZYPPER',)
Provide a default for
--no-zypper
- ('MPM_ALL_MANAGERS',)
Provide a default for
-a
- ('MPM_XKCD',)
Provide a default for
-x
- ('MPM_MANAGER',)
Provide a default for
-m
- ('MPM_EXCLUDE',)
Provide a default for
-e
- ('MPM_IGNORE_AUTO_UPDATES',)
Provide a default for
--ignore-auto-updates
- ('MPM_STOP_ON_ERROR',)
Provide a default for
--stop-on-error
- ('MPM_DRY_RUN',)
Provide a default for
-d
- ('MPM_TIMEOUT',)
Provide a default for
-t
- ('MPM_COOLDOWN',)
Provide a default for
--cooldown
- ('MPM_REQUIRE_COOLDOWN_SUPPORT',)
Provide a default for
--require-cooldown-support
- ('MPM_DESCRIPTION',)
Provide a default for
--description
- ('MPM_SORT_BY',)
Provide a default for
-s
- ('MPM_SUMMARY',)
Provide a default for
--summary
- ('MPM_SUGGEST_CONTRIBS',)
Provide a default for
--suggest-contribs
- ('MPM_BAR_PLUGIN_PATH',)
Provide a default for
--bar-plugin-path
- ('MPM_TIME',)
Provide a default for
--time
- ('MPM_CONFIG',)
Provide a default for
--config
- ('MPM_CONFIG',)
Provide a default for
--no-config
- ('MPM_VALIDATE_CONFIG',)
Provide a default for
--validate-config
- ('MPM_ACCESSIBLE',)
Provide a default for
--accessible
- ('MPM_COLOR',)
Provide a default for
--color
- ('MPM_THEME',)
Provide a default for
--theme
- ('MPM_SHOW_PARAMS',)
Provide a default for
--show-params
- ('MPM_TABLE_FORMAT',)
Provide a default for
--table-format
- ('MPM_VERBOSITY',)
Provide a default for
--verbosity
- ('MPM_VERBOSE',)
Provide a default for
--verbose
- ('MPM_MAN',)
Provide a default for
--man
- ('MPM_VERSION',)
Provide a default for
--version
cleanupΒΆ
Cleanup local data, temporary artifacts and removes orphaned dependencies.
Usage
mpm cleanup [OPTIONS]
config-templateΒΆ
Print the overridable attributes of one or more managers as a TOML config template.
Each block is a valid [mpm.managers.<id>] section ready to paste into a
standalone config file or a [tool.mpm] pyproject.toml block. The output
lists every overridable field with its current value so it doubles as the
canonical reference for what each manager exposes: prune the rows that donβt
apply and customize the rest.
With no positional arguments, every maintained (non-deprecated) manager is dumped. Pass one or more manager IDs to restrict the output.
Usage
mpm config-template [OPTIONS] [[apk|apm|apt|apt-
mint|asdf|brew|cargo|cask|choco|composer|cpan|deb-get|dnf|
dnf5|emerge|eopkg|flatpak|fwupd|gem|guix|macports|mas|mise
|nix|npm|opkg|pacaur|pacman|pacstall|paru|pip|pipx|pkg|por
ts|pwsh-gallery|scoop|sdkman|sfsu|snap|steamcmd|stew|topgr
ade|uv|uvx|vscode|vscodium|winget|xbps|yarn|yarn-
berry|yay|yum|zerobrew|zypper]]...
Arguments
- MANAGER_IDSΒΆ
Optional argument(s)
dumpΒΆ
Dump installed packages to a TOML manifest or a Brewfile.
By default emits TOML, one section per manager (one entry per package, keyed
by package ID, with the installed version as the value). Pass --brewfile
to emit a Brewfile compatible with brew bundle install.
With no [OUTPUT_PATH] argument, writes to stdout. TOML files are readable by
mpm restore.
--merge and --update-version operate on an existing TOML file; both
require the [OUTPUT_PATH] argument and neither is valid with --brewfile.
Usage
mpm dump [OPTIONS] [OUTPUT_PATH]
Options
- --tomlΒΆ
Emit a TOML manifest with one section per manager. Default.
- --brewfileΒΆ
Emit a Brewfile that brew bundle install can consume. Only managers natively supported by brew bundle are included (brew, cask, mas, vscode, npm, cargo, uv, winget, flatpak). Other managers are tallied in the header and excluded from the output.
- --overwrite, --force, --replaceΒΆ
Allow the output file to be silently wiped out if it already exists.
- --header, --no-headerΒΆ
Include a metadata + warning comment block at the top of the output.
- --mergeΒΆ
TOML only. Read the provided file and add each new entry to it. Requires the [OUTPUT_PATH] argument.
- --update-versionΒΆ
TOML only. Read the provided file and update each existing entry with the version currently installed on the system. Requires the [OUTPUT_PATH] argument.
Arguments
- OUTPUT_PATHΒΆ
Optional argument
Environment variables
- ('DUMP_OUTPUT_FORMAT',)
Provide a default for
--toml
- ('DUMP_OUTPUT_FORMAT',)
Provide a default for
--brewfile
- ('DUMP_OVERWRITE',)
Provide a default for
--overwrite
- ('DUMP_INCLUDE_HEADER',)
Provide a default for
--header
- ('DUMP_MERGE',)
Provide a default for
--merge
- ('DUMP_UPDATE_VERSION',)
Provide a default for
--update-version
helpΒΆ
Show help for a command.
Usage
mpm help [OPTIONS] [COMMAND_PATH]...
Options
- --search <search>ΒΆ
Search all subcommands for matching options or descriptions.
Arguments
- COMMAND_PATHΒΆ
Optional argument(s)
installΒΆ
Install one or more packages.
This subcommand is sensible to the order of the package managers selected by the user.
Installation will first proceed for all the packages found to be tied to a specific manager. Which is the case for packages provided with precise package specifiers (like purl). This will also happens in situations in which a tighter selection of managers is provided by the user.
For packages whose manager is not known, or if multiple managers are candidates for the installation, mpm will try to find the best manager to install it with.
Installation will be attempted with each manager, in the order they were selected. If a search for the package ID returns no result from the highest-priority manager, we will skip the installation and try the next available managers in the order of their priority.
Usage
mpm install [OPTIONS] PACKAGES_SPECS...
Arguments
- PACKAGES_SPECSΒΆ
Required argument(s)
A mix of plain <package_id>, simple <package_id@version> specifiers or full <pkg:npm/left-pad> purls.
installedΒΆ
List all packages installed on the system by each manager.
Usage
mpm installed [OPTIONS]
Options
- -d, --duplicatesΒΆ
Only list installed packages sharing the same ID. Implies βsort-by package_id to make duplicates easier to compare between themselves.
Environment variables
- ('INSTALLED_DUPLICATES',)
Provide a default for
-d
managersΒΆ
List every package manager detected on the system.
Only reports by default all managers supported on the current platform. To include
unsupported and deprecated managers in the report, use the --all-managers
flag.
Userβs own selection configuration are intentionally ignored, so a manager dropped
from regular operations is still visible here for troubleshooting. To narrow down the
report to a subset of managers, pass the same selectors as for other subcommands (e.g.
--pip or --no-apt).
Usage
mpm managers [OPTIONS]
outdatedΒΆ
List available package upgrades and their versions for each manager.
Usage
mpm outdated [OPTIONS]
Options
- --plugin-outputΒΆ
Output results for direct consumption by an Xbar/SwiftBar-compatible plugin. The layout is dynamic and depends on environment variables set by either Xbar or SwiftBar.
Environment variables
- ('OUTDATED_PLUGIN_OUTPUT',)
Provide a default for
--plugin-output
removeΒΆ
Remove one or more packages.
Packages recognized by multiple managers will be remove with each of them. You can fine-tune this behavior with more precise package specifiers (like purl) and/or tighter selection of managers.
Packages unrecognized by any selected manager will be skipped.
Usage
mpm remove [OPTIONS] PACKAGES_SPECS...
Arguments
- PACKAGES_SPECSΒΆ
Required argument(s)
A mix of plain <package_id>, simple <package_id@version> specifiers or full <pkg:npm/left-pad> purls.
restoreΒΆ
Read TOML files then install or upgrade each package referenced in them.
Usage
mpm restore [OPTIONS] TOML_FILES...
Arguments
- TOML_FILESΒΆ
Required argument(s)
sbomΒΆ
Export list of installed packages to a SPDX or CycloneDX file.
Usage
mpm sbom [OPTIONS] [EXPORT_PATH]
Options
- --spdx, --cyclonedxΒΆ
SBOM standard to export to.
- --format <export_format>ΒΆ
File format of the export. Defaults to JSON for <stdout>. If not provided, will be autodetected from file extension.
- Options:
json | xml | yaml | tag | rdf
- --overwrite, --force, --replaceΒΆ
Allow the target file to be silently wiped out if it already exists.
- --bundled, --minimalΒΆ
Bundled mode (the default) queries each manager for richer metadata (license, supplier, homepage, checksums, declared dependencies) and merges per-package upstream SBOM documents into the aggregate when the manager publishes them (like Homebrewβs HOMEBREW_SBOM=1 per-formula files). Minimal mode lists installed packages with the bare inventory data (name, version, purl) and skips the metadata extractors entirely. Bundled mode is slower because it may shell out or read on-disk SBOM files per package; pick βminimal for fast inventory snapshots.
Arguments
- EXPORT_PATHΒΆ
Optional argument
Environment variables
- ('SBOM_SPDX',)
Provide a default for
--spdx
- ('SBOM_EXPORT_FORMAT',)
Provide a default for
--format
- ('SBOM_OVERWRITE',)
Provide a default for
--overwrite
- ('SBOM_BUNDLED',)
Provide a default for
--bundled
searchΒΆ
Search each manager for a package ID, name or description matching the query.
Usage
mpm search [OPTIONS] QUERY
Options
- --extended, --id-name-onlyΒΆ
Extend search to description, instead of restricting it to package ID and name. Implies βdescription.
- --exact, --fuzzyΒΆ
Only returns exact matches on package ID or name.
- --refilter, --no-refilterΒΆ
Let mpm refilters managersβ search results.
Arguments
- QUERYΒΆ
Required argument
Environment variables
- ('SEARCH_EXTENDED',)
Provide a default for
--extended
- ('SEARCH_EXACT',)
Provide a default for
--exact
- ('SEARCH_REFILTER',)
Provide a default for
--refilter
syncΒΆ
Sync local package metadata and info from external sources.
Usage
mpm sync [OPTIONS]
upgradeΒΆ
Upgrade one or more outdated packages.
All outdated package will be upgraded by default if no specifiers are provided as arguments. I.e. assumes -A/βall option if no [PACKAGES_SPECS]β¦.
Packages recognized by multiple managers will be upgraded with each of them. You can fine-tune this behavior with more precise package specifiers (like purl) and/or tighter selection of managers.
Packages unrecognized by any selected manager will be skipped.
Usage
mpm upgrade [OPTIONS] [PACKAGES_SPECS]...
Options
- -A, --allΒΆ
Upgrade all outdated packages. Will make the command ignore package IDs provided as parameters.
Arguments
- PACKAGES_SPECSΒΆ
Optional argument(s)
A mix of plain <package_id>, simple <package_id@version> specifiers or full <pkg:npm/left-pad> purls.
Environment variables
- ('UPGRADE_ALL',)
Provide a default for
-A
whichΒΆ
Search from the userβs environment all CLIs matching the query.
This is mpmβs own version of the which -a UNIX command, used internally to locate binaries for each manager. It is exposed as a subcommand for convenience and to help troubleshoot CLI resolution logic.
Compared to the venerable which command, this will respect the additional path configured for each package manager. It will ignore files that are empty (0 size). On Windows, it additionally suppress the default lookup in the current directory, which takes precedence on other paths.
Usage
mpm which [OPTIONS] CLI_NAMES...
Arguments
- CLI_NAMESΒΆ
Required argument(s)
Man pagesΒΆ
The directive below renders a live index of every man page emitted by click_extra.sphinx from the click_extra_manpages config in conf.py. Each entry links to the browser-viewable HTML sibling produced when mandoc (preferred) or groff is on PATH during the docs build. The raw .1 files sit next to the HTML siblings in /man/ and are also bundled as mpm-manpages.tar.gz on every GitHub release.
mpm(1)β CLI options shared by all subcommands.mpm-cleanup(1)β Cleanup local data.mpm-config-template(1)β Print per-manager overrides as a TOML config template.mpm-dump(1)β Snapshot installed packages to a TOML manifest or a Brewfile.mpm-help(1)β Show help for a command.mpm-install(1)β Install a package.mpm-installed(1)β List installed packages.mpm-managers(1)β List every registered package manager and check its presence on the system.mpm-outdated(1)β List outdated packages.mpm-remove(1)β Remove a package.mpm-restore(1)β Install packages referenced in TOML files.mpm-sbom(1)β Export installed packages to a SBOM document.mpm-search(1)β Search packages.mpm-sync(1)β Sync local package info.mpm-upgrade(1)β Upgrade packages.mpm-which(1)β Locate CLIs on system.