CLI documentation update from CI
npm CLI robot committed
Mar 11, 2026 at 19:31 UTC
c3057669a1af2d799de37f423a5c7d9b09a53540
11 files changed
+67
-20
cli-cache.json
+2
-2
@@ -1,6 +1,6 @@
1
{
2
"v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
3
"v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
4
- "v10": "d6fe671dfb6137bf6dcbaaa23abfce95ff1d4270",
5
- "v11": "a9d242bc4f04440630141743949ddb0d323f90b4"
4
+ "v10": "49a764e354ab321da88b499fc4233eee3fa98406",
5
+ "v11": "8afa3bd21461c0984caf1bcc2e486c4881bda516"
6
}
\ No newline at end of file
content/cli/v10/commands/npm-ls.mdx
+1
-1
@@ -36,7 +36,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
36
Positional arguments are `name@version-range` identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will _also_ show the paths to the specified packages. For example, running `npm ls promzard` in npm's source tree will show:
37
38
```bash
39
-npm@10.9.5 /path/to/npm
39
+npm@10.9.6 /path/to/npm
40
└─┬ init-package-json@0.0.4
41
└── promzard@0.1.5
42
```
content/cli/v10/commands/npm.mdx
+1
-1
@@ -23,7 +23,7 @@ Note: This command is unaware of workspaces.
23
24
### Version
25
26
-10.9.5
26
+10.9.6
27
28
### Description
29
content/cli/v10/using-npm/changelog.mdx
+17
@@ -9,6 +9,23 @@ redirect_from:
9
- /cli/v10/misc/changelog
10
---
11
12
+## [10.9.6](https://github.com/npm/cli/compare/v10.9.5...v10.9.6) (2026-03-10)
13
+
14
+### Bug Fixes
15
+
16
+- [`d6fe671`](https://github.com/npm/cli/commit/d6fe671dfb6137bf6dcbaaa23abfce95ff1d4270) [#9098](https://github.com/npm/cli/pull/9098) arborist: v10 - backport multiple fixes for linked install (#9098) (@manzoorwanijk)
17
+
18
+### Dependencies
19
+
20
+- [`a5dadad`](https://github.com/npm/cli/commit/a5dadad48ecbea9783d12d355e4031f9f22d845f) [#9067](https://github.com/npm/cli/pull/9067) `tar@7.5.11`
21
+- [`87abb92`](https://github.com/npm/cli/commit/87abb92b6e426104718341462b544496ba31d226) [#9067](https://github.com/npm/cli/pull/9067) `pacote@20.0.1`
22
+- [`c2f0fd2`](https://github.com/npm/cli/commit/c2f0fd273075ed4d0ac33d17ede62f3915ccb5ef) [#9067](https://github.com/npm/cli/pull/9067) `pacote@19.0.2`
23
+- [workspace](https://github.com/npm/cli/releases/tag/arborist-v8.0.3): `@npmcli/arborist@8.0.3`
24
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v7.0.3): `libnpmdiff@7.0.3`
25
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v9.0.3): `libnpmexec@9.0.3`
26
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v6.0.3): `libnpmfund@6.0.3`
27
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v8.0.3): `libnpmpack@8.0.3`
28
+
29
## [10.9.5](https://github.com/npm/cli/compare/v10.9.4...v10.9.5) (2026-03-04)
30
31
### Bug Fixes
content/cli/v11/commands/npm-ls.mdx
+1
-1
@@ -52,7 +52,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
52
Positional arguments are `name@version-range` identifiers, which will limit the results to only the paths to the packages named. Note that nested packages will _also_ show the paths to the specified packages. For example, running `npm ls promzard` in npm's source tree will show:
53
54
```bash
55
-npm@11.11.0 /path/to/npm
55
+npm@11.11.1 /path/to/npm
56
└─┬ init-package-json@0.0.4
57
└── promzard@0.1.5
58
```
content/cli/v11/commands/npm-trust.mdx
+1
-1
@@ -38,7 +38,7 @@ redirect_from:
38
### Synopsis
39
40
```bash
41
-npm trust
41
+
42
```
43
44
Note: This command is unaware of workspaces.
content/cli/v11/commands/npm.mdx
+1
-1
@@ -31,7 +31,7 @@ Note: This command is unaware of workspaces.
31
32
### Version
33
34
-11.11.0
34
+11.11.1
35
36
### Description
37
content/cli/v11/using-npm/changelog.mdx
+35
@@ -15,6 +15,41 @@ redirect_from:
15
- /using-npm/changelog
16
---
17
18
+## [11.11.1](https://github.com/npm/cli/compare/v11.11.0...v11.11.1) (2026-03-10)
19
+
20
+### Bug Fixes
21
+
22
+- [`a9d242b`](https://github.com/npm/cli/commit/a9d242bc4f04440630141743949ddb0d323f90b4) [#9099](https://github.com/npm/cli/pull/9099) include all subcommands on main command help (#9099) (@wraithgar)
23
+- [`29b8407`](https://github.com/npm/cli/commit/29b8407971af1b9a2a3dcdb3849adfa04363fa7f) [#9087](https://github.com/npm/cli/pull/9087) unwrap comments and lines meant for output (#9087) (@wraithgar)
24
+- [`b56986a`](https://github.com/npm/cli/commit/b56986acb0661fba2c80135eff3d140aa659dcf5) [#9095](https://github.com/npm/cli/pull/9095) ls: suppress false UNMET DEPENDENCYs in linked strategy (#9095) (@manzoorwanijk)
25
+- [`76c76e5`](https://github.com/npm/cli/commit/76c76e5ad7cc5c7f641a92334b900c9d0c9a3fbd) [#9083](https://github.com/npm/cli/pull/9083) ci: don't error on optional deps in the lockfile (#9083) (@wraithgar)
26
+- [`a29aeee`](https://github.com/npm/cli/commit/a29aeee18f3ddc2348a8e00787d237c874642789) [#9028](https://github.com/npm/cli/pull/9028) arborist: retry bin-links on Windows EPERM (#9028) (@manzoorwanijk)
27
+- [`6565eeb`](https://github.com/npm/cli/commit/6565eeb818494e1feb4e14492804ce936b394b4a) [#9045](https://github.com/npm/cli/pull/9045) bypass packument cache to prevent ETARGET errors after publish (#9045) (@Jadu07)
28
+
29
+### Documentation
30
+
31
+- [`3b96929`](https://github.com/npm/cli/commit/3b96929166a55f7f0c346f9715988ec1e1ce195d) [#9074](https://github.com/npm/cli/pull/9074) scripts: remove mention of obsolete root user behavior (#9074) (@mohd-akram)
32
+- [`16ac4e0`](https://github.com/npm/cli/commit/16ac4e02796248f3abb4fa043427236cda22a902) [#9054](https://github.com/npm/cli/pull/9054) fix workspace cross-dependency documentation (@owlstronaut)
33
+
34
+### Dependencies
35
+
36
+- [`075ae23`](https://github.com/npm/cli/commit/075ae23e46d821c56a0f50f56b2d6c745fe7367e) [#9086](https://github.com/npm/cli/pull/9086) `tar@7.5.11`
37
+- [`13fa40d`](https://github.com/npm/cli/commit/13fa40d4ce8f7b0ea3e437056faca693472b3efa) [#9086](https://github.com/npm/cli/pull/9086) `pacote@21.5.0`
38
+- [`bf7ea2b`](https://github.com/npm/cli/commit/bf7ea2b19f5446d3c3a33de2844f7504cc418570) [#9060](https://github.com/npm/cli/pull/9060) `brace-expansion@5.0.4`
39
+- [`2000d2c`](https://github.com/npm/cli/commit/2000d2ce858c79664c6255d78485580b0d65f5b4) [#9060](https://github.com/npm/cli/pull/9060) `minimatch@10.2.4`
40
+- [`d86b260`](https://github.com/npm/cli/commit/d86b260103358e6f8dd7d9cc2526ac3144d595c8) [#9060](https://github.com/npm/cli/pull/9060) `tar@7.5.10`
41
+- [`dff1853`](https://github.com/npm/cli/commit/dff1853ed6e5b4acfdd36d0109cb2ebe27693a6f) [#9060](https://github.com/npm/cli/pull/9060) `@npmcli/run-script@10.0.4`
42
+- [`93c3365`](https://github.com/npm/cli/commit/93c33658f6ac4e83cff83a0e064b222f1b36a515) [#9060](https://github.com/npm/cli/pull/9060) `write-file-atomic@7.0.1`
43
+
44
+### Chores
45
+
46
+- [`d1996a7`](https://github.com/npm/cli/commit/d1996a7a79982f616600d134dbdcfb223cd0d81d) [#9060](https://github.com/npm/cli/pull/9060) dev dependency updates (@wraithgar)
47
+- [workspace](https://github.com/npm/cli/releases/tag/arborist-v9.4.1): `@npmcli/arborist@9.4.1`
48
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v8.1.4): `libnpmdiff@8.1.4`
49
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v10.2.4): `libnpmexec@10.2.4`
50
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v7.0.18): `libnpmfund@7.0.18`
51
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v9.1.4): `libnpmpack@9.1.4`
52
+
53
## [11.11.0](https://github.com/npm/cli/compare/v11.10.1...v11.11.0) (2026-02-25)
54
55
### Features
content/cli/v11/using-npm/scripts.mdx
-4
@@ -235,10 +235,6 @@ For more details, see:
235
- [npm v7 release notes](https://github.com/npm/cli/releases/tag/v7.0.0)
236
- [Discussion about script working directory reliability in npm v6 and earlier](https://github.com/npm/npm/issues/12356)
237
238
-### User
239
-
240
-When npm is run as root, scripts are always run with the effective uid and gid of the working directory owner.
241
-
238
### Environment
239
240
Package scripts run in an environment where many pieces of information are made available regarding the setup of npm and the current state of the process.
content/cli/v11/using-npm/workspaces.mdx
+4
-6
@@ -95,24 +95,22 @@ npm install abbrev -w a
95
96
**Adding a workspace as a dependency of another workspace:**
97
98
-If you want to add workspace **b** as a dependency of workspace **a**, you can use the workspace protocol in the dependency specifier:
98
+The same approach works when adding one workspace as a dependency of another. If you want to add workspace **b** as a dependency of workspace **a**, run:
99
100
```
101
-npm install b@workspace:* -w a
101
+npm install b -w a
102
```
103
104
-This will add an entry to workspace **a**'s `package.json` like:
104
+npm will detect that **b** is a workspace and automatically symlink it rather than fetching it from the registry. The resulting entry in workspace **a**'s `package.json` will use a standard version range:
105
106
```json
107
{
108
"dependencies": {
109
- "b": "workspace:*"
109
+ "b": "^1.0.0"
110
}
111
}
112
```
113
114
-The `workspace:` protocol tells npm to link to the local workspace rather than fetching from the registry. The `*` version means it will use whatever version is defined in workspace **b**'s `package.json`.
115
-
114
Note: other installing commands such as `uninstall`, `ci`, etc will also respect the provided `workspace` configuration.
115
116
### Using workspaces
content/nav.yml
+4
-3
@@ -1326,7 +1326,7 @@
1326
- title: Changelog
1327
url: /cli/v9/using-npm/changelog
1328
description: Changelog notes for each version
1329
- - title: Version 10.9.5
1329
+ - title: Version 10.9.6
1330
shortName: v10
1331
url: /cli/v10
1332
default: false
@@ -1596,7 +1596,7 @@
1596
- title: Changelog
1597
url: /cli/v10/using-npm/changelog
1598
description: Changelog notes for each version
1599
- - title: Version 11.11.0
1599
+ - title: Version 11.11.1
1600
shortName: v11
1601
url: /cli/v11
1602
default: true
@@ -1788,7 +1788,8 @@
1788
description: Manage your authentication tokens
1789
- title: npm trust
1790
url: /cli/v11/commands/npm-trust
1791
- description: Manage trusted publishing relationships between packages and CI/CD providers
1791
+ description: Manage trusted publishing relationships between packages and CI/CD
1792
+ providers
1793
- title: npm undeprecate
1794
url: /cli/v11/commands/npm-undeprecate
1795
description: Undeprecate a version of a package