pnpm list

Aliases: ls

This command will output all the versions of packages that are installed, as well as their dependencies, in a tree-structure.

Positional arguments are name-pattern@version-range identifiers, which will limit the results to only the packages named. For example, pnpm list "babel-*" "eslint-*" semver@5.

Options#

--recursive, -r#

Perform command on every package in subdirectories or on every workspace package, when executed inside a workspace.

--json#

Log output in JSON format.

--long#

Show extended information.

--lockfile-only#

Added in: v10.23.0

Read package information from the lockfile instead of checking the actual node_modules directory. This is useful for quickly inspecting what would be installed without requiring a full installation.

--parseable#

Outputs package directories in a parseable format instead of their tree view.

--global, -g#

List packages in the global install directory instead of in the current project.

--depth <number>#

Max display depth of the dependency tree.

pnpm ls --depth 0 (default) will list direct dependencies only. pnpm ls --depth -1 will list projects only. Useful inside a workspace when used with the -r option. pnpm ls --depth Infinity will list all dependencies regardless of depth.

--prod, -P#

Display only the dependency graph for packages in dependencies and optionalDependencies.

--dev, -D#

Display only the dependency graph for packages in devDependencies.

--no-optional#

Don't display packages from optionalDependencies.

--only-projects#

Display only dependencies that are also projects within the workspace.

--exclude-peers#

Exclude peer dependencies from the results (but dependencies of peer dependencies are not ignored).

--filter <package_selector>#

Read more about filtering.