@cryptotaxi247 / documentation-1 / commits / ef9ed48

CLI documentation update from CI

npm CLI robot committed Jul 24, 2025 at 16:54 UTC ef9ed48376df4629545a39add92ac4f9c7923c2b
16 files changed +98 -20
cli-cache.json
+1 -1
@@ -2,5 +2,5 @@
2 "v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
3 "v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
4 "v10": "f69c403700acb05dbb56d8516bca5130627e597c",
5 - "v11": "804a9646e41d3aaa11ed084aa0c9997b7375882f"
5 + "v11": "946b34a1c1a364acfed36ba5f2eaa3c6e5036e19"
6 }
\ No newline at end of file
content/cli/v11/commands/npm-bugs.mdx
+1 -1
@@ -51,7 +51,7 @@ This command tries to guess at the likely location of a package's bug tracker UR
51
52 #### `browser`
53
54 -- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
54 +- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
55 - Type: null, Boolean, or String
56
57 The browser that is called by npm commands to open websites.
content/cli/v11/commands/npm-docs.mdx
+1 -1
@@ -51,7 +51,7 @@ This command tries to guess at the likely location of a package's documentation
51
52 #### `browser`
53
54 -- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
54 +- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
55 - Type: null, Boolean, or String
56
57 The browser that is called by npm commands to open websites.
content/cli/v11/commands/npm-fund.mdx
+1 -1
@@ -96,7 +96,7 @@ Not supported by all npm commands.
96
97 #### `browser`
98
99 -- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
99 +- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
100 - Type: null, Boolean, or String
101
102 The browser that is called by npm commands to open websites.
content/cli/v11/commands/npm-install-test.mdx
+9
@@ -186,6 +186,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
186
187 When "true" submit audit reports alongside the current npm command to the default registry and all registries configured for scopes. See the documentation for [`npm audit`](/cli/v11/commands/npm-audit) for details on what is submitted.
188
189 +#### `before`
190 +
191 +- Default: null
192 +- Type: null or Date
193 +
194 +If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the given date are installed. If there are no versions available for the current set of dependencies, the command will error.
195 +
196 +If the requested version is a `dist-tag` and the given tag does not pass the `--before` filter, the most recent version less than or equal to that tag will be used. For example, `foo@latest` might install `foo@1.2` even though `latest` is `2.0`.
197 +
198 #### `bin-links`
199
200 - Default: true
content/cli/v11/commands/npm-install.mdx
+9
@@ -465,6 +465,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
465
466 When "true" submit audit reports alongside the current npm command to the default registry and all registries configured for scopes. See the documentation for [`npm audit`](/cli/v11/commands/npm-audit) for details on what is submitted.
467
468 +#### `before`
469 +
470 +- Default: null
471 +- Type: null or Date
472 +
473 +If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the given date are installed. If there are no versions available for the current set of dependencies, the command will error.
474 +
475 +If the requested version is a `dist-tag` and the given tag does not pass the `--before` filter, the most recent version less than or equal to that tag will be used. For example, `foo@latest` might install `foo@1.2` even though `latest` is `2.0`.
476 +
477 #### `bin-links`
478
479 - Default: true
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.4.2 /path/to/npm
55 +npm@11.5.0 /path/to/npm
56 └─┬ init-package-json@0.0.4
57 └── promzard@0.1.5
58 ```
content/cli/v11/commands/npm-outdated.mdx
+9
@@ -151,6 +151,15 @@ When set for the `npm init` command, this may be set to the folder of a workspac
151
152 This value is not exported to the environment for child processes.
153
154 +#### `before`
155 +
156 +- Default: null
157 +- Type: null or Date
158 +
159 +If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the given date are installed. If there are no versions available for the current set of dependencies, the command will error.
160 +
161 +If the requested version is a `dist-tag` and the given tag does not pass the `--before` filter, the most recent version less than or equal to that tag will be used. For example, `foo@latest` might install `foo@1.2` even though `latest` is `2.0`.
162 +
163 ### See Also
164
165 - [package spec](/cli/v11/using-npm/package-spec)
content/cli/v11/commands/npm-repo.mdx
+1 -1
@@ -49,7 +49,7 @@ This command tries to guess at the likely location of a package's repository URL
49
50 #### `browser`
51
52 -- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
52 +- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
53 - Type: null, Boolean, or String
54
55 The browser that is called by npm commands to open websites.
content/cli/v11/commands/npm-update.mdx
+9
@@ -271,6 +271,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
271
272 When "true" submit audit reports alongside the current npm command to the default registry and all registries configured for scopes. See the documentation for [`npm audit`](/cli/v11/commands/npm-audit) for details on what is submitted.
273
274 +#### `before`
275 +
276 +- Default: null
277 +- Type: null or Date
278 +
279 +If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the given date are installed. If there are no versions available for the current set of dependencies, the command will error.
280 +
281 +If the requested version is a `dist-tag` and the given tag does not pass the `--before` filter, the most recent version less than or equal to that tag will be used. For example, `foo@latest` might install `foo@1.2` even though `latest` is `2.0`.
282 +
283 #### `bin-links`
284
285 - Default: true
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.4.2
34 +11.5.0
35
36 ### Description
37
content/cli/v11/configuring-npm/install.mdx
+2 -8
@@ -47,9 +47,9 @@ If you are unable to use a Node version manager, you can use a Node installer to
47 - [Node.js installer](https://nodejs.org/en/download/)
48 - [NodeSource installer](https://github.com/nodesource/distributions). If you use Linux, we recommend that you use a NodeSource installer.
49
50 -#### OS X or Windows Node installers
50 +#### macOS or Windows Node installers
51
52 -If you're using OS X or Windows, use one of the installers from the [Node.js download page](https://nodejs.org/en/download/). Be sure to install the version labeled **LTS**. Other versions have not yet been tested with npm.
52 +If you're using macOS or Windows, use one of the installers from the [Node.js download page](https://nodejs.org/en/download/). Be sure to install the version labeled **LTS**. Other versions have not yet been tested with npm.
53
54 #### Linux or other operating systems Node installers
55
@@ -59,9 +59,3 @@ If you're using Linux or another operating system, use one of the following inst
59 - One of the installers on the [Node.js download page](https://nodejs.org/en/download/)
60
61 Or see [this page](https://nodejs.org/en/download/package-manager/) to install npm for Linux in the way many Linux developers prefer.
62 -
63 -#### Less-common operating systems
64 -
65 -For more information on installing Node.js on a variety of operating systems, see [this page][pkg-mgr].
66 -
67 -[pkg-mgr]: https://nodejs.org/en/download/package-manager/
content/cli/v11/using-npm/changelog.mdx
+48
@@ -15,6 +15,54 @@ redirect_from:
15 - /using-npm/changelog
16 ---
17
18 +## [11.5.0](https://github.com/npm/cli/compare/v11.4.2...v11.5.0) (2025-07-24)
19 +
20 +### Features
21 +
22 +- [`1cce318`](https://github.com/npm/cli/commit/1cce31810eb5ff1e0f7c8ee4516e7c73cedb38a1) [#8336](https://github.com/npm/cli/pull/8336) adds support for oidc publish (#8336) (@reggi)
23 +
24 +### Bug Fixes
25 +
26 +- [`7f66f0a`](https://github.com/npm/cli/commit/7f66f0ae8fb84f567fe83a9a5738d06c7fe8fb54) [#8447](https://github.com/npm/cli/pull/8447) add better hint for `before` and clean up description (@wraithgar)
27 +- [`280817a`](https://github.com/npm/cli/commit/280817a0a5b4e2aebd4b2f39c79ac9af58165edf) [#8447](https://github.com/npm/cli/pull/8447) add --before param to command help output (@wraithgar)
28 +- [`6e47325`](https://github.com/npm/cli/commit/6e47325e59f19e4e563b5f9308cff165739088a2) [#8441](https://github.com/npm/cli/pull/8441) Makes 404 errors less scary without revealing existence (#8441) (@owlstronaut)
29 +- [`0a97ffd`](https://github.com/npm/cli/commit/0a97ffdf8b2df40a5f24b710415eb0c9aaa82f5d) [#8429](https://github.com/npm/cli/pull/8429) handle signal exits gracefully (@owlstronaut)
30 +- [`5b858c6`](https://github.com/npm/cli/commit/5b858c6b2c275f0e670e09c52de5b931936d6e07) [#8411](https://github.com/npm/cli/pull/8411) ensure progress bars display consistently across all environments (#8411) (@owlstronaut)
31 +
32 +### Documentation
33 +
34 +- [`ef3529e`](https://github.com/npm/cli/commit/ef3529ec4b45901c95182850e8e9da8dae833227) [#8435](https://github.com/npm/cli/pull/8435) add test snapshot (#8435) (@reggi, @wraithgar)
35 +- [`b7758d7`](https://github.com/npm/cli/commit/b7758d73d6b715a62e6d0c48e11b87017ce2b71c) [#8418](https://github.com/npm/cli/pull/8418) remove reference to Node.js download less common os (#8418) (@MikeMcC399)
36 +- [`746ac5d`](https://github.com/npm/cli/commit/746ac5d95dc19a74c519a8e3f3e1eed029957921) [#8380](https://github.com/npm/cli/pull/8380) remove duplicate info (#8380) (@alexsch01)
37 +- [`4673e9c`](https://github.com/npm/cli/commit/4673e9c165b39563e16409f3b1ca06fdc32e7d44) [#8371](https://github.com/npm/cli/pull/8371) rebrand OS X references to macOS (@MikeMcC399)
38 +
39 +### Dependencies
40 +
41 +- [`398fed4`](https://github.com/npm/cli/commit/398fed45af63a8f7e3f5da8fc882674befd39216) [#8450](https://github.com/npm/cli/pull/8450) `normalize-package-data@7.0.1`
42 +- [`5b242c9`](https://github.com/npm/cli/commit/5b242c9302e9ae1405b5ecbc76eb290c0f72634d) [#8450](https://github.com/npm/cli/pull/8450) `validate-npm-package-name@6.0.2`
43 +- [`d4e8a8a`](https://github.com/npm/cli/commit/d4e8a8aba42f146a5feb20da262f92d0c3100986) [#8450](https://github.com/npm/cli/pull/8450) `tuf-js@3.1.0`
44 +- [`e1b37b2`](https://github.com/npm/cli/commit/e1b37b2c84346eba3451369753756381658214b5) [#8450](https://github.com/npm/cli/pull/8450) `picomatch@4.0.3`
45 +- [`3cb5884`](https://github.com/npm/cli/commit/3cb58842ff65a9ca2b31306e0e71ccf9ee5702e5) [#8450](https://github.com/npm/cli/pull/8450) `socks@2.8.6`
46 +- [`daea981`](https://github.com/npm/cli/commit/daea98168b636b89ced80ab6d895ba7d9c5c8e20) [#8450](https://github.com/npm/cli/pull/8450) `ci-info@4.3.0`
47 +- [`39ad47d`](https://github.com/npm/cli/commit/39ad47dd46dd69bcf16eb7dd5b6d8efec0d5d1c2) [#8450](https://github.com/npm/cli/pull/8450) `aproba@2.1.0`
48 +- [`a789f33`](https://github.com/npm/cli/commit/a789f334757b691db02fcc182781d02b41e8bb5c) [#8450](https://github.com/npm/cli/pull/8450) `agent-base@7.1.4`
49 +- [`1c0d257`](https://github.com/npm/cli/commit/1c0d257aa015297b703d0f413928bff661ed1430) [#8450](https://github.com/npm/cli/pull/8450) `@npmcli/metavuln-calculator@9.0.1`
50 +
51 +### Chores
52 +
53 +- [`804a964`](https://github.com/npm/cli/commit/804a9646e41d3aaa11ed084aa0c9997b7375882f) [#8450](https://github.com/npm/cli/pull/8450) update devDependencies in lockfile (@wraithgar)
54 +- [`643ae71`](https://github.com/npm/cli/commit/643ae7104e5246a8ea10bfbd4f98540945c8430d) [#8450](https://github.com/npm/cli/pull/8450) update mock-registry to use local arborist (@wraithgar)
55 +- [`cf023d7`](https://github.com/npm/cli/commit/cf023d71135427f2fdb290162432802e8a1514da) [#8421](https://github.com/npm/cli/pull/8421) contributing: prepare easier copy-paste contributing commands (#8421) (@MikeMcC399)
56 +- [`3f60b5f`](https://github.com/npm/cli/commit/3f60b5f9621b43ae0b8796d3a7160a603748f756) [#8383](https://github.com/npm/cli/pull/8383) `@npmcli/template-oss@4.24.4` (#8383) (@wraithgar)
57 +- [`01f8cc6`](https://github.com/npm/cli/commit/01f8cc6f001e3211135fa0563f7129aed09dc46c) [#8381](https://github.com/npm/cli/pull/8381) `@npmcli/template-oss@4.24.3` (#8381) (@wraithgar)
58 +- [workspace](https://github.com/npm/cli/releases/tag/arborist-v9.1.3): `@npmcli/arborist@9.1.3`
59 +- [workspace](https://github.com/npm/cli/releases/tag/config-v10.3.1): `@npmcli/config@10.3.1`
60 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v8.0.6): `libnpmdiff@8.0.6`
61 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v10.1.5): `libnpmexec@10.1.5`
62 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v7.0.6): `libnpmfund@7.0.6`
63 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v9.0.6): `libnpmpack@9.0.6`
64 +- [workspace](https://github.com/npm/cli/releases/tag/libnpmpublish-v11.1.0): `libnpmpublish@11.1.0`
65 +
66 ## [11.4.2](https://github.com/npm/cli/compare/v11.4.1...v11.4.2) (2025-06-11)
67
68 ### Bug Fixes
content/cli/v11/using-npm/config.mdx
+3 -3
@@ -173,7 +173,7 @@ What authentication strategy to use with `login`. Note that if an `otp` config i
173 - Default: null
174 - Type: null or Date
175
176 -If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the `--before` time get installed. If there's no versions available for the current set of direct dependencies, the command will error.
176 +If passed to `npm install`, will rebuild the npm tree such that only versions that were available **on or before** the given date are installed. If there are no versions available for the current set of dependencies, the command will error.
177
178 If the requested version is a `dist-tag` and the given tag does not pass the `--before` filter, the most recent version less than or equal to that tag will be used. For example, `foo@latest` might install `foo@1.2` even though `latest` is `2.0`.
179
@@ -188,7 +188,7 @@ Set to false to have it not do this. This can be used to work around the fact th
188
189 #### `browser`
190
191 -- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
191 +- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
192 - Type: null, Boolean, or String
193
194 The browser that is called by npm commands to open websites.
@@ -900,7 +900,7 @@ The "prerelease identifier" to use as a prefix for the "prerelease" part of a se
900
901 #### `progress`
902
903 -- Default: `true` unless running in a known CI system
903 +- Default: `true` when not in CI and both stderr and stdout are TTYs and not in a dumb terminal
904 - Type: Boolean
905
906 When set to `true`, npm will display a progress bar during time intensive operations, if `process.stderr` and `process.stdout` are a TTY.
content/cli/v11/using-npm/scripts.mdx
+1 -1
@@ -19,7 +19,7 @@ redirect_from:
19
20 ### Description
21
22 -The `"scripts"` property of your `package.json` file supports a number of built-in scripts and their preset life cycle events as well as arbitrary scripts. These all can be executed by running `npm run <stage>` or `npm run <stage>` for short. _Pre_ and _post_ commands with matching names will be run for those as well (e.g. `premyscript`, `myscript`, `postmyscript`). Scripts from dependencies can be run with `npm explore <pkg> -- npm run <stage>`.
22 +The `"scripts"` property of your `package.json` file supports a number of built-in scripts and their preset life cycle events as well as arbitrary scripts. These all can be executed by running `npm run <stage>`. _Pre_ and _post_ commands with matching names will be run for those as well (e.g. `premyscript`, `myscript`, `postmyscript`). Scripts from dependencies can be run with `npm explore <pkg> -- npm run <stage>`.
23
24 ### Pre & Post Scripts
25
content/nav.yml
+1 -1
@@ -1594,7 +1594,7 @@
1594 - title: Changelog
1595 url: /cli/v10/using-npm/changelog
1596 description: Changelog notes for each version
1597 - - title: Version 11.4.2
1597 + - title: Version 11.5.0
1598 shortName: v11
1599 url: /cli/v11
1600 default: true