CLI documentation update from CI

npm-cli-bot · npm-cli-bot · commit ef9ed48376df · 2025-07-24T16:54:53.000Z
diff --git a/cli-cache.json b/cli-cache.json
@@ -2,5 +2,5 @@
   "v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",
   "v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",
   "v10": "f69c403700acb05dbb56d8516bca5130627e597c",
-  "v11": "804a9646e41d3aaa11ed084aa0c9997b7375882f"
+  "v11": "946b34a1c1a364acfed36ba5f2eaa3c6e5036e19"
 }
diff --git a/content/cli/v11/commands/npm-bugs.mdx b/content/cli/v11/commands/npm-bugs.mdx
@@ -51,7 +51,7 @@ This command tries to guess at the likely location of a package's bug tracker UR
 
 #### `browser`
 
-- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
 - Type: null, Boolean, or String
 
 The browser that is called by npm commands to open websites.
diff --git a/content/cli/v11/commands/npm-docs.mdx b/content/cli/v11/commands/npm-docs.mdx
@@ -51,7 +51,7 @@ This command tries to guess at the likely location of a package's documentation
 
 #### `browser`
 
-- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
 - Type: null, Boolean, or String
 
 The browser that is called by npm commands to open websites.
diff --git a/content/cli/v11/commands/npm-fund.mdx b/content/cli/v11/commands/npm-fund.mdx
@@ -96,7 +96,7 @@ Not supported by all npm commands.
 
 #### `browser`
 
-- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
 - Type: null, Boolean, or String
 
 The browser that is called by npm commands to open websites.
diff --git a/content/cli/v11/commands/npm-install-test.mdx b/content/cli/v11/commands/npm-install-test.mdx
@@ -186,6 +186,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
 
 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.
 
+#### `before`
+
+- Default: null
+- Type: null or Date
+
+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.
+
+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`.
+
 #### `bin-links`
 
 - Default: true
diff --git a/content/cli/v11/commands/npm-install.mdx b/content/cli/v11/commands/npm-install.mdx
@@ -465,6 +465,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
 
 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.
 
+#### `before`
+
+- Default: null
+- Type: null or Date
+
+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.
+
+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`.
+
 #### `bin-links`
 
 - Default: true
diff --git a/content/cli/v11/commands/npm-ls.mdx b/content/cli/v11/commands/npm-ls.mdx
@@ -52,7 +52,7 @@ Note: to get a "bottoms up" view of why a given package is included in the tree
 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:
 
 ```bash
-npm@11.4.2 /path/to/npm
+npm@11.5.0 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 ```
diff --git a/content/cli/v11/commands/npm-outdated.mdx b/content/cli/v11/commands/npm-outdated.mdx
@@ -151,6 +151,15 @@ When set for the `npm init` command, this may be set to the folder of a workspac
 
 This value is not exported to the environment for child processes.
 
+#### `before`
+
+- Default: null
+- Type: null or Date
+
+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.
+
+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`.
+
 ### See Also
 
 - [package spec](/cli/v11/using-npm/package-spec)
diff --git a/content/cli/v11/commands/npm-repo.mdx b/content/cli/v11/commands/npm-repo.mdx
@@ -49,7 +49,7 @@ This command tries to guess at the likely location of a package's repository URL
 
 #### `browser`
 
-- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
 - Type: null, Boolean, or String
 
 The browser that is called by npm commands to open websites.
diff --git a/content/cli/v11/commands/npm-update.mdx b/content/cli/v11/commands/npm-update.mdx
@@ -271,6 +271,15 @@ Note that commands explicitly intended to run a particular script, such as `npm
 
 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.
 
+#### `before`
+
+- Default: null
+- Type: null or Date
+
+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.
+
+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`.
+
 #### `bin-links`
 
 - Default: true
diff --git a/content/cli/v11/commands/npm.mdx b/content/cli/v11/commands/npm.mdx
@@ -31,7 +31,7 @@ Note: This command is unaware of workspaces.
 
 ### Version
 
-11.4.2
+11.5.0
 
 ### Description
 
diff --git a/content/cli/v11/configuring-npm/install.mdx b/content/cli/v11/configuring-npm/install.mdx
@@ -47,9 +47,9 @@ If you are unable to use a Node version manager, you can use a Node installer to
 - [Node.js installer](https://nodejs.org/en/download/)
 - [NodeSource installer](https://github.com/nodesource/distributions). If you use Linux, we recommend that you use a NodeSource installer.
 
-#### OS X or Windows Node installers
+#### macOS or Windows Node installers
 
-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.
+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.
 
 #### Linux or other operating systems Node installers
 
@@ -59,9 +59,3 @@ If you're using Linux or another operating system, use one of the following inst
 - One of the installers on the [Node.js download page](https://nodejs.org/en/download/)
 
 Or see [this page](https://nodejs.org/en/download/package-manager/) to install npm for Linux in the way many Linux developers prefer.
-
-#### Less-common operating systems
-
-For more information on installing Node.js on a variety of operating systems, see [this page][pkg-mgr].
-
-[pkg-mgr]: https://nodejs.org/en/download/package-manager/
diff --git a/content/cli/v11/using-npm/changelog.mdx b/content/cli/v11/using-npm/changelog.mdx
@@ -15,6 +15,54 @@ redirect_from:
   - /using-npm/changelog
 ---
 
+## [11.5.0](https://github.com/npm/cli/compare/v11.4.2...v11.5.0) (2025-07-24)
+
+### Features
+
+- [`1cce318`](https://github.com/npm/cli/commit/1cce31810eb5ff1e0f7c8ee4516e7c73cedb38a1) [#8336](https://github.com/npm/cli/pull/8336) adds support for oidc publish (#8336) (@reggi)
+
+### Bug Fixes
+
+- [`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)
+- [`280817a`](https://github.com/npm/cli/commit/280817a0a5b4e2aebd4b2f39c79ac9af58165edf) [#8447](https://github.com/npm/cli/pull/8447) add --before param to command help output (@wraithgar)
+- [`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)
+- [`0a97ffd`](https://github.com/npm/cli/commit/0a97ffdf8b2df40a5f24b710415eb0c9aaa82f5d) [#8429](https://github.com/npm/cli/pull/8429) handle signal exits gracefully (@owlstronaut)
+- [`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)
+
+### Documentation
+
+- [`ef3529e`](https://github.com/npm/cli/commit/ef3529ec4b45901c95182850e8e9da8dae833227) [#8435](https://github.com/npm/cli/pull/8435) add test snapshot (#8435) (@reggi, @wraithgar)
+- [`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)
+- [`746ac5d`](https://github.com/npm/cli/commit/746ac5d95dc19a74c519a8e3f3e1eed029957921) [#8380](https://github.com/npm/cli/pull/8380) remove duplicate info (#8380) (@alexsch01)
+- [`4673e9c`](https://github.com/npm/cli/commit/4673e9c165b39563e16409f3b1ca06fdc32e7d44) [#8371](https://github.com/npm/cli/pull/8371) rebrand OS X references to macOS (@MikeMcC399)
+
+### Dependencies
+
+- [`398fed4`](https://github.com/npm/cli/commit/398fed45af63a8f7e3f5da8fc882674befd39216) [#8450](https://github.com/npm/cli/pull/8450) `normalize-package-data@7.0.1`
+- [`5b242c9`](https://github.com/npm/cli/commit/5b242c9302e9ae1405b5ecbc76eb290c0f72634d) [#8450](https://github.com/npm/cli/pull/8450) `validate-npm-package-name@6.0.2`
+- [`d4e8a8a`](https://github.com/npm/cli/commit/d4e8a8aba42f146a5feb20da262f92d0c3100986) [#8450](https://github.com/npm/cli/pull/8450) `tuf-js@3.1.0`
+- [`e1b37b2`](https://github.com/npm/cli/commit/e1b37b2c84346eba3451369753756381658214b5) [#8450](https://github.com/npm/cli/pull/8450) `picomatch@4.0.3`
+- [`3cb5884`](https://github.com/npm/cli/commit/3cb58842ff65a9ca2b31306e0e71ccf9ee5702e5) [#8450](https://github.com/npm/cli/pull/8450) `socks@2.8.6`
+- [`daea981`](https://github.com/npm/cli/commit/daea98168b636b89ced80ab6d895ba7d9c5c8e20) [#8450](https://github.com/npm/cli/pull/8450) `ci-info@4.3.0`
+- [`39ad47d`](https://github.com/npm/cli/commit/39ad47dd46dd69bcf16eb7dd5b6d8efec0d5d1c2) [#8450](https://github.com/npm/cli/pull/8450) `aproba@2.1.0`
+- [`a789f33`](https://github.com/npm/cli/commit/a789f334757b691db02fcc182781d02b41e8bb5c) [#8450](https://github.com/npm/cli/pull/8450) `agent-base@7.1.4`
+- [`1c0d257`](https://github.com/npm/cli/commit/1c0d257aa015297b703d0f413928bff661ed1430) [#8450](https://github.com/npm/cli/pull/8450) `@npmcli/metavuln-calculator@9.0.1`
+
+### Chores
+
+- [`804a964`](https://github.com/npm/cli/commit/804a9646e41d3aaa11ed084aa0c9997b7375882f) [#8450](https://github.com/npm/cli/pull/8450) update devDependencies in lockfile (@wraithgar)
+- [`643ae71`](https://github.com/npm/cli/commit/643ae7104e5246a8ea10bfbd4f98540945c8430d) [#8450](https://github.com/npm/cli/pull/8450) update mock-registry to use local arborist (@wraithgar)
+- [`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)
+- [`3f60b5f`](https://github.com/npm/cli/commit/3f60b5f9621b43ae0b8796d3a7160a603748f756) [#8383](https://github.com/npm/cli/pull/8383) `@npmcli/template-oss@4.24.4` (#8383) (@wraithgar)
+- [`01f8cc6`](https://github.com/npm/cli/commit/01f8cc6f001e3211135fa0563f7129aed09dc46c) [#8381](https://github.com/npm/cli/pull/8381) `@npmcli/template-oss@4.24.3` (#8381) (@wraithgar)
+- [workspace](https://github.com/npm/cli/releases/tag/arborist-v9.1.3): `@npmcli/arborist@9.1.3`
+- [workspace](https://github.com/npm/cli/releases/tag/config-v10.3.1): `@npmcli/config@10.3.1`
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmdiff-v8.0.6): `libnpmdiff@8.0.6`
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmexec-v10.1.5): `libnpmexec@10.1.5`
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmfund-v7.0.6): `libnpmfund@7.0.6`
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmpack-v9.0.6): `libnpmpack@9.0.6`
+- [workspace](https://github.com/npm/cli/releases/tag/libnpmpublish-v11.1.0): `libnpmpublish@11.1.0`
+
 ## [11.4.2](https://github.com/npm/cli/compare/v11.4.1...v11.4.2) (2025-06-11)
 
 ### Bug Fixes
diff --git a/content/cli/v11/using-npm/config.mdx b/content/cli/v11/using-npm/config.mdx
@@ -173,7 +173,7 @@ What authentication strategy to use with `login`. Note that if an `otp` config i
 - Default: null
 - Type: null or Date
 
-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.
+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.
 
 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`.
 
@@ -188,7 +188,7 @@ Set to false to have it not do this. This can be used to work around the fact th
 
 #### `browser`
 
-- Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
+- Default: macOS: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
 - Type: null, Boolean, or String
 
 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
 
 #### `progress`
 
-- Default: `true` unless running in a known CI system
+- Default: `true` when not in CI and both stderr and stdout are TTYs and not in a dumb terminal
 - Type: Boolean
 
 When set to `true`, npm will display a progress bar during time intensive operations, if `process.stderr` and `process.stdout` are a TTY.
diff --git a/content/cli/v11/using-npm/scripts.mdx b/content/cli/v11/using-npm/scripts.mdx
@@ -19,7 +19,7 @@ redirect_from:
 
 ### Description
 
-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>`.
+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>`.
 
 ### Pre & Post Scripts
 
diff --git a/content/nav.yml b/content/nav.yml
@@ -1594,7 +1594,7 @@
             - title: Changelog
               url: /cli/v10/using-npm/changelog
               description: Changelog notes for each version
-    - title: Version 11.4.2
+    - title: Version 11.5.0
       shortName: v11
       url: /cli/v11
       default: true

Original file line number	Diff line number	Diff line change
`@@ -2,5 +2,5 @@`
`2`	`2`	`"v8": "aa8fff11cdab94fff1a2160ee5241f5f4632e96b",`
`3`	`3`	`"v9": "64763a341e7aa5b456e696f956759bf9b3440dc1",`
`4`	`4`	`"v10": "f69c403700acb05dbb56d8516bca5130627e597c",`
`5`		`- "v11": "804a9646e41d3aaa11ed084aa0c9997b7375882f"`
	`5`	`+ "v11": "946b34a1c1a364acfed36ba5f2eaa3c6e5036e19"`
`6`	`6`	`}`
-Original file line number
+Diff line change
 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:
 ```bash
 -npm@11.4.2 /path/to/npm
 +npm@11.5.0 /path/to/npm
 └─┬ [email protected]
   └── [email protected]
 ```