pnpm remove

Aliases: rm, uninstall, un, uni

Removes packages from node_modules and from the project's package.json.

pnpm remove <pkg>...

Without a --save-* option, the package is removed from every dependency field.

With Python or Cargo enabled, use pypi:<name> or crate:<name> to remove a dependency from pyproject.toml or Cargo.toml and update its lockfile. Package URLs such as pkg:pypi/example and pkg:cargo/example also work. Removing Python or Cargo dependencies requires exact names and does not support exclusions.

Patterns#

Added in: v12.23.0

A selector can be a glob pattern. A selector that starts with ! excludes the dependencies it matches, even ones named exactly. Quote patterns so the shell does not expand them.

pnpm remove "eslint-*" "!eslint-plugin-import"

A pattern that matches no dependency removes nothing and does not fail. An exact name that is not a dependency still fails with ERR_PNPM_CANNOT_REMOVE_MISSING_DEPS.

Options#

--recursive, -r#

When used inside a workspace, removes a dependency (or dependencies) from every workspace package.

When used not inside a workspace, removes a dependency (or dependencies) from every package found in subdirectories.

--global, -g#

Remove a global package and unlink its bins from the global bin directory.

--save-dev, -D#

Only remove the dependency from devDependencies.

--save-optional, -O#

Only remove the dependency from optionalDependencies.

--save-prod, -P#

Only remove the dependency from dependencies.

--lockfile-only#

Update package.json and pnpm-lock.yaml without changing node_modules.

--lockfile-dir <dir>#

The directory in which pnpm-lock.yaml is created. It cannot be combined with --global.

--[no-]trust-lockfile#

Added in: v12.3.0

Removing a package rewrites the lockfile, so pnpm remove verifies the whole lockfile against the active policies the way pnpm install does, not only the entries of the package being removed. --trust-lockfile skips that pass, as the trustLockfile setting does. --no-trust-lockfile verifies the lockfile even when the configuration trusts it.

The policy settings also take their pnpm install spellings here: --trust-policy, --trust-policy-exclude, and --trust-policy-ignore-after.

--filter <package_selector>#

Read more about filtering.