1---
2name: pnpm-cli-commands
3description: Essential pnpm commands for package management, running scripts, and workspace operations
4---
5 
6# pnpm CLI Commands
7 
8pnpm provides a comprehensive CLI for package management with commands similar to npm/yarn but with unique features.
9 
10## Installation Commands
11 
12### Install all dependencies
13```bash
14pnpm install
15# or
16pnpm i
17```
18 
19### Add a dependency
20```bash
21# Production dependency
22pnpm add <pkg>
23 
24# Dev dependency
25pnpm add -D <pkg>
26pnpm add --save-dev <pkg>
27 
28# Optional dependency
29pnpm add -O <pkg>
30 
31# Global package
32pnpm add -g <pkg>
33 
34# Specific version
35pnpm add <pkg>@<version>
36pnpm add <pkg>@next
37pnpm add <pkg>@^1.0.0
38```
39 
40### Remove a dependency
41```bash
42pnpm remove <pkg>
43pnpm rm <pkg>
44pnpm uninstall <pkg>
45pnpm un <pkg>
46```
47 
48### Update dependencies
49```bash
50# Update all
51pnpm update
52pnpm up
53 
54# Update specific package
55pnpm update <pkg>
56 
57# Update to latest (ignore semver)
58pnpm update --latest
59pnpm up -L
60 
61# Interactive update
62pnpm update --interactive
63pnpm up -i
64```
65 
66## Script Commands
67 
68### Run scripts
69```bash
70pnpm run <script>
71# or shorthand
72pnpm <script>
73 
74# Pass arguments to script
75pnpm run build -- --watch
76 
77# Run script if exists (no error if missing)
78pnpm run --if-present build
79```
80 
81### Execute binaries
82```bash
83# Run local binary
84pnpm exec <command>
85 
86# Example
87pnpm exec eslint .
88```
89 
90### dlx - Run without installing
91```bash
92# Like npx but for pnpm
93pnpm dlx <pkg>
94 
95# Examples
96pnpm dlx create-vite my-app
97pnpm dlx degit user/repo my-project
98```
99 
100## Workspace Commands
101 
102### Run in all packages
103```bash
104# Run script in all workspace packages
105pnpm -r run <script>
106pnpm --recursive run <script>
107 
108# Run in specific packages
109pnpm --filter <pattern> run <script>
110 
111# Examples
112pnpm --filter "./packages/**" run build
113pnpm --filter "!./packages/internal/**" run test
114pnpm --filter "@myorg/*" run lint
115```
116 
117### Filter patterns
118```bash
119# By package name
120pnpm --filter <pkg-name> <command>
121pnpm --filter "@scope/pkg" build
122 
123# By directory
124pnpm --filter "./packages/core" test
125 
126# Dependencies of a package
127pnpm --filter "...@scope/app" build
128 
129# Dependents of a package
130pnpm --filter "@scope/core..." test
131 
132# Changed packages since commit/branch
133pnpm --filter "...[origin/main]" build
134```
135 
136## Other Useful Commands
137 
138### Link packages
139```bash
140# Link global package
141pnpm link --global
142pnpm link -g
143 
144# Use linked package
145pnpm link --global <pkg>
146```
147 
148### Patch packages
149```bash
150# Create patch for a package
151pnpm patch <pkg>@<version>
152 
153# After editing, commit the patch
154pnpm patch-commit <path>
155 
156# Remove a patch
157pnpm patch-remove <pkg>
158```
159 
160### Store management
161```bash
162# Show store path
163pnpm store path
164 
165# Remove unreferenced packages
166pnpm store prune
167 
168# Check store integrity
169pnpm store status
170```
171 
172### Other commands
173```bash
174# Clean install (like npm ci)
175pnpm install --frozen-lockfile
176 
177# List installed packages
178pnpm list
179pnpm ls
180 
181# Why is package installed?
182pnpm why <pkg>
183 
184# Outdated packages
185pnpm outdated
186 
187# Audit for vulnerabilities
188pnpm audit
189 
190# Rebuild native modules
191pnpm rebuild
192 
193# Import from npm/yarn lockfile
194pnpm import
195 
196# Create tarball
197pnpm pack
198 
199# Publish package
200pnpm publish
201```
202 
203## Useful Flags
204 
205```bash
206# Ignore scripts
207pnpm install --ignore-scripts
208 
209# Prefer offline (use cache)
210pnpm install --prefer-offline
211 
212# Strict peer dependencies
213pnpm install --strict-peer-dependencies
214 
215# Production only
216pnpm install --prod
217pnpm install -P
218 
219# No optional dependencies
220pnpm install --no-optional
221```
222 
223<!-- 
224Source references:
225- https://pnpm.io/cli/install
226- https://pnpm.io/cli/add
227- https://pnpm.io/cli/run
228- https://pnpm.io/filtering
229-->
230