pnpm is a fast, disk space efficient package manager. It uses a
content-addressable store to deduplicate packages across all projects on a
machine, saving significant disk space. pnpm enforces strict dependency
resolution by default, preventing phantom dependencies. Configuration should
preferably be placed in pnpm-workspace.yaml for pnpm-specific settings.
Important: When working with pnpm projects, agents should check for
pnpm-workspace.yaml and .npmrc files to understand workspace structure and
configuration. Always use --frozen-lockfile in CI environments.
The skill is based on pnpm 10.x, generated at 2026-01-28.
Core
| Topic |
Description |
Reference |
| CLI Commands |
Install, add, remove, update, run, exec, dlx, and workspace commands |
core-cli |
| Configuration |
pnpm-workspace.yaml, .npmrc settings, and package.json fields |
core-config |
| Workspaces |
Monorepo support with filtering, workspace protocol, and shared lockfile |
core-workspaces |
| Store |
Content-addressable storage, hard links, and disk efficiency |
core-store |
Features
| Topic |
Description |
Reference |
| Catalogs |
Centralized dependency version management for workspaces |
features-catalogs |
| Overrides |
Force specific versions of dependencies including transitive |
features-overrides |
| Patches |
Modify third-party packages with custom fixes |
features-patches |
| Aliases |
Install packages under custom names using npm: protocol |
features-aliases |
| Hooks |
Customize resolution with .pnpmfile.cjs hooks |
features-hooks |
| Peer Dependencies |
Auto-install, strict mode, and dependency rules |
features-peer-deps |
Best Practices
| Topic |
Description |
Reference |
| CI/CD Setup |
GitHub Actions, GitLab CI, Docker, and caching strategies |
best-practices-ci |
| Migration |
Migrating from npm/Yarn, handling phantom deps, monorepo migration |
best-practices-migration |
| Performance |
Install optimizations, store caching, workspace parallelization |
best-practices-performance |
1---2name: pnpm3description: Node.js package manager with strict dependency resolution. Use when running pnpm specific commands, configuring workspaces, or managing dependencies with catalogs, patches, or overrides.4---56pnpm is a fast, disk space efficient package manager. It uses a7content-addressable store to deduplicate packages across all projects on a8machine, saving significant disk space. pnpm enforces strict dependency9resolution by default, preventing phantom dependencies. Configuration should10preferably be placed in `pnpm-workspace.yaml` for pnpm-specific settings.1112**Important:** When working with pnpm projects, agents should check for13`pnpm-workspace.yaml` and `.npmrc` files to understand workspace structure and14configuration. Always use `--frozen-lockfile` in CI environments.1516> The skill is based on pnpm 10.x, generated at 2026-01-28.1718## Core1920| Topic | Description | Reference |21| ------------- | ------------------------------------------------------------------------ | ------------------------------------------------ |22| CLI Commands | Install, add, remove, update, run, exec, dlx, and workspace commands | [core-cli](references/core-cli.md) |23| Configuration | pnpm-workspace.yaml, .npmrc settings, and package.json fields | [core-config](references/core-config.md) |24| Workspaces | Monorepo support with filtering, workspace protocol, and shared lockfile | [core-workspaces](references/core-workspaces.md) |25| Store | Content-addressable storage, hard links, and disk efficiency | [core-store](references/core-store.md) |2627## Features2829| Topic | Description | Reference |30| ----------------- | ------------------------------------------------------------ | ------------------------------------------------------ |31| Catalogs | Centralized dependency version management for workspaces | [features-catalogs](references/features-catalogs.md) |32| Overrides | Force specific versions of dependencies including transitive | [features-overrides](references/features-overrides.md) |33| Patches | Modify third-party packages with custom fixes | [features-patches](references/features-patches.md) |34| Aliases | Install packages under custom names using npm: protocol | [features-aliases](references/features-aliases.md) |35| Hooks | Customize resolution with .pnpmfile.cjs hooks | [features-hooks](references/features-hooks.md) |36| Peer Dependencies | Auto-install, strict mode, and dependency rules | [features-peer-deps](references/features-peer-deps.md) |3738## Best Practices3940| Topic | Description | Reference |41| ----------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------- |42| CI/CD Setup | GitHub Actions, GitLab CI, Docker, and caching strategies | [best-practices-ci](references/best-practices-ci.md) |43| Migration | Migrating from npm/Yarn, handling phantom deps, monorepo migration | [best-practices-migration](references/best-practices-migration.md) |44| Performance | Install optimizations, store caching, workspace parallelization | [best-practices-performance](references/best-practices-performance.md) |
christopher-buss