Managing the package store.
Checks for modified packages in the store.
Returns exit code 0 if the content of the package is the same as it was at the time of unpacking.
Added in: v2.12.0
Functionally equivalent to
pnpm add, except this adds new packages to the store directly without modifying any projects or files outside of the store.
Removes unreferenced packages from the store.
Unreferenced packages are packages that are not used by any projects on the system. Packages can become unreferenced after most installation operations, for instance when dependencies are made redundant.
For example, during
pnpm install, package
firstname.lastname@example.org is updated to
email@example.com. pnpm will keep
firstname.lastname@example.org in the store, as it does not automatically remove packages. If package
email@example.com is not used by any other project on the system, it becomes unreferenced. Running
pnpm store prune would remove
firstname.lastname@example.org from the store.
pnpm store prune is not harmful and has no side effects on your projects. If future installations require removed packages, pnpm will download them again.
It is best practice to run
pnpm store prune occasionally to clean up the store, but not too frequently. Sometimes, unreferenced packages become required again. This could occur when switching branches and installing older dependencies, in which case pnpm would need to re-download all removed packages, briefly slowing down the installation process.
Please note that this command is prohibited when a store server is running.
Added in: v6.10.0
Returns the path to the active store directory.