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.

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.

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_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_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 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

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.