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