MPM-DUMP(1) MPM-DUMP(1)

mpm dump - Snapshot installed packages to a TOML manifest or a Brewfile.

mpm dump [OPTIONS] [OUTPUT_PATH]

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.

[OUTPUT_PATH]

Emit a TOML manifest with one section per manager. Default.
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.
Allow the output file to be silently wiped out if it already exists.
Include a metadata + warning comment block at the top of the output.
TOML only. Read the provided file and add each new entry to it. Requires the [OUTPUT_PATH] argument.
TOML only. Read the provided file and update each existing entry with the version currently installed on the system. Requires the [OUTPUT_PATH] argument.
Show this message and exit.

Emit a TOML manifest with one section per manager. Default.
Allow the output file to be silently wiped out if it already exists.
Include a metadata + warning comment block at the top of the output.
TOML only. Read the provided file and add each new entry to it. Requires the [OUTPUT_PATH] argument.
TOML only. Read the provided file and update each existing entry with the version currently installed on the system. Requires the [OUTPUT_PATH] argument.
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.
2026-06-19