Observed string: "#

corepackCorepack is a zero-runtime-dependency Node.js script that acts as a bridgebetween Node.js projects and the package managers they are intended to be usedwith during development. In practical terms, **Corepack lets you use Yarn, npm,and pnpm without having to install them**.## How to Install### Default InstallsCorepack is [distributed by default with all recent Node.js versions](https://nodejs.org/api/corepack.html).Run `corepack enable` to install the required Yarn and pnpm binaries on your path.### Manual Installs

Install Corepack using npm

First uninstall your global Yarn and pnpm binaries (just leave npm). In general,you'd do this by running the following command:```shellnpm uninstall -g yarn pnpm# That should be enough, but if you installed Yarn without going through npm it might# be more tedious - for example, you might need to run `brew uninstall yarn` as well.Then install Corepack:```shellnpm install -g corepackWe do acknowledge the irony and overhead of using npm to install Corepack, whichis at least part of why the preferred option is to use the Corepack version thatis distributed along with Node.js itself.

Install Corepack from source

See [`CONTRIBUTING.md`](./CONTRIBUTING.md).

## Usage### When Building PackagesJust use your package managers as you usually would. Run `yarn install` in Yarnprojects, `pnpm install` in pnpm projects, and `npm` in npm projects. Corepackwill catch these calls, and depending on the situation:- **If the local project is configured for the package manager you're using**, Corepack will silently download and cache the latest compatible version.- **If the local project is configured for a different package manager**, Corepack will request you to run the command again using the right package manager - thus avoiding corruptions of your install artifacts.- **If the local project isn't configured for any package manager**, Corepack will assume that you know what you're doing, and will use whatever package manager version has been pinned as "known good release". Check the relevant section for more details.### When Authoring PackagesSet your package's manager with the `packageManager` field in `package.json`:```json "packageManager": "yarn@3.2.3+sha224.953c8233f7a92884eee2de69a1b92d1f2ec1655e66d08071ba9a02fa"Here, `yarn` is the name of the package manager, specified at version `3.2.3`,along with the SHA-224 hash of this version for validation.`packageManager@x.y.z` is required. The hash is optional but stronglyrecommended as a security practice. Permitted values for the package manager are`yarn`, `npm`, and `pnpm`.## Known Good ReleasesWhen running Corepack within projects that don't list a supported packagemanager, it will default to a set of Known Good Releases. In a way, you cancompare this to Node.js, where each version ships with a specific version ofnpm.If there is no Known Good Release for the requested package manager, Corepacklooks up the npm registry for the latest available version and cache it forfuture use.The Known Good Releases can be updated system-wide using `corepack install -g`.## Offline WorkflowThe utility commands detailed in the next section.- Either you can use the network while building your container image, in which case you'll simply run `corepack pack` to make sure that your image includes the Last Known Good release for the specified package manager. - If you want to have _all_ Last Known Good releases for all package managers, just use the `--all` flag which will do just that.- Or you're publishing your project to a system where the network is unavailable, in which case you'll preemptively generate a package manager archive from your local computer (using `corepack pack -o`) before storing it somewhere your container will be able to access (for example within your repository). After that it'll just be a matter of running `corepack install -g --cache-only ` to setup the cache.## Utility Commands### `corepack [@] [... args]`This meta-command runs the specified package manager in the local folder. Youcan use it to force an install to run with a given version, which can be usefulwhen looking for regressions.Note that those commands still check whether the local project is configured forthe given package manager (ie you won't be able to run `corepack yarn install`on a project where the `packageManager` field references `pnpm`).### `corepack enable [... name]`| Option | Description || --------------------- | --------------------------------------- || `--install-directory` | Add the shims to the specified location |This command will detect where Corepack is installed and will create shims nextto it for each of the specified package managers (or all of them if the commandis called without parameters). Note that the npm shims will not be installedunless explicitly requested, as npm is currently distributed with Node.jsthrough other means.If the file system where the `corepack` binary is located is read-only, thiscommand will fail. A workaround is to add the binaries as alias in yourshell configuration file (e.g. in `~/.bash_aliases`):```shalias yarn="corepack yarn"alias yarnpkg="corepack yarnpkg"alias pnpm="corepack pnpm"alias pnpx="corepack pnpx"alias npm="corepack npm"alias npx="corepack npx"On Windows PowerShell, you can add functions using the `$PROFILE` automaticvariable:```powershellecho "function yarn { corepack yarn `$args }" >> $PROFILEecho "function yarnpkg { corepack yarnpkg `$args }" >> $PROFILEecho "function pnpm { corepack pnpm `$args }" >> $PROFILEecho "function pnpx { corepack pnpx `$args }" >> $PROFILEecho "function npm { corepack npm `$args }" >> $PROFILEecho "function npx { corepack npx `$args }" >> $PROFILE### `corepack disable [... name]`| Option | Description || --------------------- | ------------------------------------------ || `--install-directory` | Remove the shims to the specified location |This command will detect where Node.js is installed and will remove the shimsfrom there.### `corepack install`Download and install the package manager configured in the local project.This command doesn't change the global version used when running the packagemanager from outside the project (use the \`-g,--global\` flag if you wishto do this).### `corepack install <-g,--global> [--all] [... name@version]`| Option | Description || --------------------- | ------------------------------------------ || `--all` | Install all Last Known Good releases |Install the selected package managers and install them on the system.Package managers thus installed will be configured as the new default whencalling their respective binaries outside of projects defining the`packageManager` field.### `corepack pack [--all] [... name@version]`| Option | Description || --------------------- | ------------------------------------------ || `--all` | Pack all Last Known Good releases || `--json ` | Print the output folder rather than logs || `-o,--output ` | Path where to generate the archive |Download the selected package managers and store them inside a tarballsuitable for use with `corepack install -g`.### `corepack use `When run, this command will retrieve the latest release matching the provideddescriptor, assign it to the project's package.json file, and automaticallyperform an install.### `corepack up`Retrieve the latest available version for the current major release line ofthe package manager used in the local project, and update the project to useUnlike `corepack use` this command doesn't take a package manager name nor aversion range, as it will always select the latest available version from thesame major line. Should you need to upgrade to a new major, use an explicit`corepack use {name}@latest` call.## Environment Variables- `COREPACK_DEFAULT_TO_LATEST` can be set to `0` in order to instruct Corepack not to lookup on the remote registry for the latest version of the selected package manager.- `COREPACK_ENABLE_NETWORK` can be set to `0` to prevent Corepack from accessing the network (in which case you'll be responsible for hydrating the package manager versions that will be required for the projects you'll run, using `corepack install -g --cache-only`).- `COREPACK_ENABLE_STRICT` can be set to `0` to prevent Corepack from throwing error if the package manager does not correspond to the one defined for the current project. This means that if a user is using the package manager specified in the current project, it will use the version specified by the project's `packageManager` field. But if the user is using other package manager different from the one specified for the current project, it will use the system-wide package manager version.- `COREPACK_ENABLE_PROJECT_SPEC` can be set to `0` to prevent Corepack from checking if the package manager corresponds to the one defined for the current project. This means that it will always use the system-wide package manager regardless of what is being specified in the project's `packageManager` field.- `COREPACK_HOME` can be set in order to define where Corepack should install the package managers. By default it is set to `%LOCALAPPDATA%\node\corepack` on Windows, and to `$HOME/.cache/node/corepack` everywhere else.- `COREPACK_ROOT` has no functional impact on Corepack itself; it's automatically being set in your environment by Corepack when it shells out to the underlying package managers, so that they can feature-detect its presence (useful for commands like `yarn init`).- `COREPACK_NPM_REGISTRY` sets the registry base url used when retrieving package managers from npm. Default value is `https://registry.npmjs.org`- `COREPACK_NPM_TOKEN` sets a Bearer token authorization header when connecting to a npm type registry.- `COREPACK_NPM_USERNAME` and `COREPACK_NPM_PASSWORD` to set a Basic authorization header when connecting to a npm type registry. Note that both environment variables are required and as plain text. If you want to send an empty password, explicitly set `COREPACK_NPM_PASSWORD` to an empty string.- `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` are supported through [`node-proxy-agent`](https://github.com/TooTallNate/node-proxy-agent).## Troubleshooting### NetworkingThere are a wide variety of networking issues that can occur while running `corepack` commands. Things to check:- Make sure your network connection is active.- Make sure the host for your request can be resolved by your DNS; try using `curl [URL]` (ipv4) and `curl -6 [URL]` (ipv6) from your shell.- Check your proxy settings (see [Environment Variables](#environment-variables)).## ContributingSee [`CONTRIBUTING.md`](./CONTRIBUTING.md).## DesignSee [`DESIGN.md`](/DESIGN.md).## License (MIT)See [`LICENSE.md`](./LICENSE.md)." (Indicator: "curl -") in Source: README.md