Skip to content

Commit c305766

Browse files
committed
CLI documentation update from CI
1 parent cff87d3 commit c305766

File tree

11 files changed

+67
-20
lines changed

11 files changed

+67
-20
lines changed

cli-cache.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
33
"v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
4-
"v10": "d6fe671dfb6137bf6dcbaaa23abfce95ff1d4270",
5-
"v11": "a9d242bc4f04440630141743949ddb0d323f90b4"
4+
"v10": "49a764e354ab321da88b499fc4233eee3fa98406",
5+
"v11": "8afa3bd21461c0984caf1bcc2e486c4881bda516"
66
}

content/cli/v10/commands/npm-ls.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
3636
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:
3737

3838
```bash
39-
npm@10.9.5 /path/to/npm
39+
npm@10.9.6 /path/to/npm
4040
└─┬ init-package-json@0.0.4
4141
└── promzard@0.1.5
4242
```

content/cli/v10/commands/npm.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Note: This command is unaware of workspaces.
2323

2424
### Version
2525

26-
10.9.5
26+
10.9.6
2727

2828
### Description
2929

content/cli/v10/using-npm/changelog.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,23 @@ redirect_from:
99
- /cli/v10/misc/changelog
1010
---
1111

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+
1229
## [10.9.5](https://github.com/npm/cli/compare/v10.9.4...v10.9.5) (2026-03-04)
1330

1431
### Bug Fixes

content/cli/v11/commands/npm-ls.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
5252
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:
5353

5454
```bash
55-
npm@11.11.0 /path/to/npm
55+
npm@11.11.1 /path/to/npm
5656
└─┬ init-package-json@0.0.4
5757
└── promzard@0.1.5
5858
```

content/cli/v11/commands/npm-trust.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ redirect_from:
3838
### Synopsis
3939

4040
```bash
41-
npm trust
41+
4242
```
4343

4444
Note: This command is unaware of workspaces.

content/cli/v11/commands/npm.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Note: This command is unaware of workspaces.
3131

3232
### Version
3333

34-
11.11.0
34+
11.11.1
3535

3636
### Description
3737

content/cli/v11/using-npm/changelog.mdx

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,41 @@ redirect_from:
1515
- /using-npm/changelog
1616
---
1717

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+
1853
## [11.11.0](https://github.com/npm/cli/compare/v11.10.1...v11.11.0) (2026-02-25)
1954

2055
### Features

content/cli/v11/using-npm/scripts.mdx

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -235,10 +235,6 @@ For more details, see:
235235
- [npm v7 release notes](https://github.com/npm/cli/releases/tag/v7.0.0)
236236
- [Discussion about script working directory reliability in npm v6 and earlier](https://github.com/npm/npm/issues/12356)
237237

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-
242238
### Environment
243239

244240
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

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -95,24 +95,22 @@ npm install abbrev -w a
9595

9696
**Adding a workspace as a dependency of another workspace:**
9797

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:
9999

100100
```
101-
npm install b@workspace:* -w a
101+
npm install b -w a
102102
```
103103

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:
105105

106106
```json
107107
{
108108
"dependencies": {
109-
"b": "workspace:*"
109+
"b": "^1.0.0"
110110
}
111111
}
112112
```
113113

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-
116114
Note: other installing commands such as `uninstall`, `ci`, etc will also respect the provided `workspace` configuration.
117115

118116
### Using workspaces

0 commit comments

Comments
 (0)