{
"name": "pnpm",
"description": "Fast, disk space efficient package manager",
"subcommands": [
{
"name": "add",
"description": "Installs a package and any packages that it depends on. By default, any new package is installed as a production dependency",
"options": [
{
"names": [
"--offline"
],
"description": "If true, pnpm will use only packages already available in the store. If a package won't be found locally, the installation will fail"
},
{
"names": [
"--prefer-offline"
],
"description": "If true, staleness checks for cached data will be bypassed, but missing data will be requested from the server. To force full offline mode, use --offline"
},
{
"names": [
"--ignore-scripts"
],
"description": "Do not execute any scripts defined in the project package.json and its dependencies"
},
{
"names": [
"--reporter"
],
"description": "Allows you to choose the reporter that will log debug info to the terminal about the installation progress",
"takes_arg": true,
"arg": {
"name": "Reporter Type",
"suggestions": [
"silent",
"default",
"append-only",
"ndjson"
]
}
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Install the specified packages as regular dependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Install the specified packages as devDependencies"
},
{
"names": [
"-O",
"--save-optional"
],
"description": "Install the specified packages as optionalDependencies"
},
{
"names": [
"--no-save"
],
"description": "Prevents saving to `dependencies`"
},
{
"names": [
"-E",
"--save-exact"
],
"description": "Saved dependencies will be configured with an exact version rather than using pnpm's default semver range operator"
},
{
"names": [
"--save-peer"
],
"description": "Using --save-peer will add one or more packages to peerDependencies and install them as dev dependencies"
},
{
"names": [
"--ignore-workspace-root-check",
"-W#"
],
"description": "Adding a new dependency to the root workspace package fails, unless the --ignore-workspace-root-check or -W flag is used.\nFor instance, pnpm add debug -W"
},
{
"names": [
"--global",
"-g"
],
"description": "Install a package globally"
},
{
"names": [
"--workspace"
],
"description": "Only adds the new dependency if it is found in the workspace"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "package",
"is_variadic": true
}
]
},
{
"name": "install",
"aliases": [
"i"
],
"description": "Pnpm install is used to install all dependencies for a project.\nIn a CI environment, installation fails if a lockfile is present but needs an update.\nInside a workspace, pnpm install installs all depe",
"args": [
{
"name": "package",
"is_variadic": true
}
]
},
{
"name": "install-test",
"aliases": [
"it"
],
"description": "Runs pnpm install followed immediately by pnpm test. It takes exactly the same arguments as pnpm install",
"options": [
{
"names": [
"--offline"
],
"description": "If true, pnpm will use only packages already available in the store. If a package won't be found locally, the installation will fail"
},
{
"names": [
"--prefer-offline"
],
"description": "If true, staleness checks for cached data will be bypassed, but missing data will be requested from the server. To force full offline mode, use --offline"
},
{
"names": [
"--ignore-scripts"
],
"description": "Do not execute any scripts defined in the project package.json and its dependencies"
},
{
"names": [
"--reporter"
],
"description": "Allows you to choose the reporter that will log debug info to the terminal about the installation progress",
"takes_arg": true,
"arg": {
"name": "Reporter Type",
"suggestions": [
"silent",
"default",
"append-only",
"ndjson"
]
}
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Pnpm will not install any package listed in devDependencies if the NODE_ENV environment variable is set to production.\nUse this flag to instruct pnpm to ignore NODE_ENV and take its production status "
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Only devDependencies are installed regardless of the NODE_ENV"
},
{
"names": [
"--no-optional"
],
"description": "OptionalDependencies are not installed"
},
{
"names": [
"--lockfile-only"
],
"description": "When used, only updates pnpm-lock.yaml and package.json instead of checking node_modules and downloading dependencies"
},
{
"names": [
"--frozen-lockfile"
],
"description": "If true, pnpm doesn't generate a lockfile and fails to install if the lockfile is out of sync with the manifest / an update is needed or no lockfile is present"
},
{
"names": [
"--use-store-server"
],
"description": "Starts a store server in the background. The store server will keep running after installation is done. To stop the store server, run pnpm server stop"
},
{
"names": [
"--shamefully-hoist"
],
"description": "Creates a flat node_modules structure, similar to that of npm or yarn. WARNING: This is highly discouraged"
}
]
},
{
"name": "update",
"aliases": [
"upgrade",
"up"
],
"description": "Pnpm update updates packages to their latest version based on the specified range.\nWhen used without arguments, updates all dependencies. You can use patterns to update specific dependencies",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Concurrently runs update in all subdirectories with a package.json (excluding node_modules)"
},
{
"names": [
"--latest",
"-L"
],
"description": "Ignores the version range specified in package.json. Instead, the version specified by the latest tag will be used (potentially upgrading the packages across major versions)"
},
{
"names": [
"--global"
],
"description": "Update global packages"
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Only update packages in dependencies and optionalDependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Only update packages in devDependencies"
},
{
"names": [
"--no-optional"
],
"description": "Don't update packages in optionalDependencies"
},
{
"names": [
"--interactive",
"-i"
],
"description": "Show outdated dependencies and select which ones to update"
},
{
"names": [
"--workspace"
],
"description": "Tries to link all packages from the workspace. Versions are updated to match the versions of packages inside the workspace.\nIf specific packages are updated, the command will fail if any of the update"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
}
]
},
{
"name": "remove",
"aliases": [
"rm",
"uninstall",
"un"
],
"description": "Removes packages from node_modules and from the project's package.json",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "When used inside a workspace, removes a dependency (or dependencies) from every workspace package.\nWhen used not inside a workspace, removes a dependency (or dependencies) from every package found in "
},
{
"names": [
"--global"
],
"description": "Remove a global package"
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Only remove the dependency from dependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Only remove the dependency from devDependencies"
},
{
"names": [
"--save-optional",
"-O"
],
"description": "Only remove the dependency from optionalDependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
}
]
},
{
"name": "link",
"aliases": [
"ln"
],
"description": "Makes the current local package accessible system-wide, or in another location",
"options": [
{
"names": [
"--dir",
"-C"
],
"description": "Changes the link location to <dir>"
},
{
"names": [
"--global"
],
"description": "Links the specified package (<pkg>) from global node_modules to the node_nodules of package from where this command was executed or specified via --dir option"
}
],
"args": [
{
"name": "Package",
"is_variadic": true
},
{
"template": "filepaths"
}
]
},
{
"name": "unlink",
"description": "Unlinks a system-wide package (inverse of pnpm link).\nIf called without arguments, all linked dependencies will be unlinked.\nThis is similar to yarn unlink, except pnpm re-installs the dependency afte",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Unlink in every package found in subdirectories or in every workspace package, when executed inside a workspace"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
},
{
"template": "filepaths"
}
]
},
{
"name": "import",
"description": "Pnpm import generates a pnpm-lock.yaml from an npm package-lock.json (or npm-shrinkwrap.json) file"
},
{
"name": "rebuild",
"aliases": [
"rb"
],
"description": "Rebuild a package",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "This command runs the pnpm rebuild command in every package of the monorepo"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
},
{
"template": "filepaths"
}
]
},
{
"name": "prune",
"description": "Removes unnecessary packages",
"options": [
{
"names": [
"--prod"
],
"description": "Remove the packages specified in devDependencies"
},
{
"names": [
"--no-optional"
],
"description": "Remove the packages specified in optionalDependencies"
}
]
},
{
"name": "fetch",
"description": "EXPERIMENTAL FEATURE: Fetch packages from a lockfile into virtual store, package manifest is ignored: https://pnpm.io/cli/fetch",
"options": [
{
"names": [
"--prod"
],
"description": "Development packages will not be fetched"
},
{
"names": [
"--dev"
],
"description": "Only development packages will be fetched"
}
]
},
{
"name": "patch",
"description": "This command will cause a package to be extracted in a temporary directory intended to be editable at will",
"options": [
{
"names": [
"--edit-dir"
],
"description": "The package that needs to be patched will be extracted to this directory"
}
],
"args": [
{
"name": "package"
}
]
},
{
"name": "patch-commit",
"description": "Generate a patch out of a directory",
"args": [
{
"name": "dir"
}
]
},
{
"name": "patch-remove",
"args": [
{
"name": "package",
"is_variadic": true
}
]
},
{
"name": "audit",
"description": "Checks for known security issues with the installed packages.\nIf security issues are found, try to update your dependencies via pnpm update.\nIf a simple update does not fix all the issues, use overrid",
"options": [
{
"names": [
"--audit-level"
],
"description": "Only print advisories with severity greater than or equal to <severity>",
"takes_arg": true,
"arg": {
"name": "Audit Level",
"suggestions": [
"low",
"moderate",
"high",
"critical"
]
}
},
{
"names": [
"--fix"
],
"description": "Add overrides to the package.json file in order to force non-vulnerable versions of the dependencies"
},
{
"names": [
"--json"
],
"description": "Output audit report in JSON format"
},
{
"names": [
"--dev",
"-D"
],
"description": "Only audit dev dependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only audit production dependencies"
},
{
"names": [
"--no-optional"
],
"description": "Don't audit optionalDependencies"
},
{
"names": [
"--ignore-registry-errors"
],
"description": "If the registry responds with a non-200 status code, the process should exit with 0. So the process will fail only if the registry actually successfully responds with found vulnerabilities"
}
]
},
{
"name": "list",
"aliases": [
"ls"
],
"description": "This command will output all the versions of packages that are installed, as well as their dependencies, in a tree-structure.\nPositional arguments are name-pattern@version-range identifiers, which wil",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Perform command on every package in subdirectories or on every workspace package, when executed inside a workspace"
},
{
"names": [
"--json"
],
"description": "Log output in JSON format"
},
{
"names": [
"--long"
],
"description": "Show extended information"
},
{
"names": [
"--parseable"
],
"description": "Outputs package directories in a parseable format instead of their tree view"
},
{
"names": [
"--global"
],
"description": "List packages in the global install directory instead of in the current project"
},
{
"names": [
"--depth"
],
"description": "Max display depth of the dependency tree.\npnpm ls --depth 0 will list direct dependencies only. pnpm ls --depth -1 will list projects only. Useful inside a workspace when used with the -r option",
"takes_arg": true,
"arg": {
"name": "number"
}
},
{
"names": [
"--dev",
"-D"
],
"description": "Only list dev dependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only list production dependencies"
},
{
"names": [
"--no-optional"
],
"description": "Don't list optionalDependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
]
},
{
"name": "outdated",
"description": "Checks for outdated packages. The check can be limited to a subset of the installed packages by providing arguments (patterns are supported)",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Check for outdated dependencies in every package found in subdirectories, or in every workspace package when executed inside a workspace"
},
{
"names": [
"--long"
],
"description": "Print details"
},
{
"names": [
"--global"
],
"description": "List outdated global packages"
},
{
"names": [
"--no-table"
],
"description": "Prints the outdated dependencies in a list format instead of the default table. Good for small consoles"
},
{
"names": [
"--compatible"
],
"description": "Prints only versions that satisfy specifications in package.json"
},
{
"names": [
"--dev",
"-D"
],
"description": "Only list dev dependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only list production dependencies"
},
{
"names": [
"--no-optional"
],
"description": "Doesn't check optionalDependencies"
}
]
},
{
"name": "why",
"description": "Shows all packages that depend on the specified package",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Show the dependency tree for the specified package on every package in subdirectories or on every workspace package when executed inside a workspace"
},
{
"names": [
"--json"
],
"description": "Log output in JSON format"
},
{
"names": [
"--long"
],
"description": "Show verbose output"
},
{
"names": [
"--parseable"
],
"description": "Show parseable output instead of tree view"
},
{
"names": [
"--global"
],
"description": "List packages in the global install directory instead of in the current project"
},
{
"names": [
"--dev",
"-D"
],
"description": "Only display the dependency tree for packages in devDependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only display the dependency tree for packages in dependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "run",
"aliases": [
"run-script"
],
"description": "Runs a script defined in the package's manifest file",
"options": [
{
"names": [
"-r",
"--recursive"
],
"description": "This runs an arbitrary command from each package's \"scripts\" object. If a package doesn't have the command, it is skipped. If none of the packages have the command, the command fails"
},
{
"names": [
"--if-present"
],
"description": "You can use the --if-present flag to avoid exiting with a non-zero exit code when the script is undefined. This lets you run potentially undefined scripts without breaking the execution chain"
},
{
"names": [
"--parallel"
],
"description": "Completely disregard concurrency and topological sorting, running a given script immediately in all matching packages with prefixed streaming output. This is the preferred flag for long-running proces"
},
{
"names": [
"--stream"
],
"description": "Stream output from child processes immediately, prefixed with the originating package directory. This allows output from different packages to be interleaved"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "exec",
"description": "Execute a shell command in scope of a project.\nnode_modules/.bin is added to the PATH, so pnpm exec allows executing commands of dependencies",
"options": [
{
"names": [
"-r",
"--recursive"
],
"description": "Execute the shell command in every project of the workspace.\nThe name of the current package is available through the environment variable PNPM_PACKAGE_NAME (supported from pnpm v2.22.0 onwards)"
},
{
"names": [
"--parallel"
],
"description": "Completely disregard concurrency and topological sorting, running a given script immediately in all matching packages with prefixed streaming output. This is the preferred flag for long-running proces"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "test",
"aliases": [
"t",
"tst"
],
"description": "Runs an arbitrary command specified in the package's test property of its scripts object.\nThe intended usage of the property is to specify a command that runs unit or integration testing for your prog"
},
{
"name": "start",
"description": "Runs an arbitrary command specified in the package's start property of its scripts object. If no start property is specified on the scripts object, it will attempt to run node server.js as a default, "
},
{
"name": "publish",
"description": "Publishes a package to the registry.\nWhen publishing a package inside a workspace, the LICENSE file from the root of the workspace is packed with the package (unless the package has a license of its o",
"options": [
{
"names": [
"--tag"
],
"description": "Publishes the package with the given tag. By default, pnpm publish updates the latest tag",
"takes_arg": true,
"arg": {
"name": "<tag>"
}
},
{
"names": [
"--dry-run"
],
"description": "Does everything a publish would do except actually publishing to the registry"
},
{
"names": [
"--ignore-scripts"
],
"description": "Ignores any publish related lifecycle scripts (prepublishOnly, postpublish, and the like)"
},
{
"names": [
"--no-git-checks"
],
"description": "Don't check if current branch is your publish branch, clean, and up-to-date"
},
{
"names": [
"--access"
],
"description": "Tells the registry whether the published package should be public or restricted",
"takes_arg": true,
"arg": {
"name": "Type",
"suggestions": [
"public",
"private"
]
}
},
{
"names": [
"--force"
],
"description": "Try to publish packages even if their current version is already found in the registry"
},
{
"names": [
"--report-summary"
],
"description": "Save the list of published packages to pnpm-publish-summary.json. Useful when some other tooling is used to report the list of published packages"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Branch"
}
]
},
{
"name": "recursive",
"aliases": [
"m",
"multi",
"-r"
],
"description": "Runs a pnpm command recursively on all subdirectories in the package or every available workspace",
"subcommands": [
{
"name": "add",
"description": "Installs a package and any packages that it depends on. By default, any new package is installed as a production dependency",
"options": [
{
"names": [
"--offline"
],
"description": "If true, pnpm will use only packages already available in the store. If a package won't be found locally, the installation will fail"
},
{
"names": [
"--prefer-offline"
],
"description": "If true, staleness checks for cached data will be bypassed, but missing data will be requested from the server. To force full offline mode, use --offline"
},
{
"names": [
"--ignore-scripts"
],
"description": "Do not execute any scripts defined in the project package.json and its dependencies"
},
{
"names": [
"--reporter"
],
"description": "Allows you to choose the reporter that will log debug info to the terminal about the installation progress",
"takes_arg": true,
"arg": {
"name": "Reporter Type",
"suggestions": [
"silent",
"default",
"append-only",
"ndjson"
]
}
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Install the specified packages as regular dependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Install the specified packages as devDependencies"
},
{
"names": [
"-O",
"--save-optional"
],
"description": "Install the specified packages as optionalDependencies"
},
{
"names": [
"--no-save"
],
"description": "Prevents saving to `dependencies`"
},
{
"names": [
"-E",
"--save-exact"
],
"description": "Saved dependencies will be configured with an exact version rather than using pnpm's default semver range operator"
},
{
"names": [
"--save-peer"
],
"description": "Using --save-peer will add one or more packages to peerDependencies and install them as dev dependencies"
},
{
"names": [
"--ignore-workspace-root-check",
"-W#"
],
"description": "Adding a new dependency to the root workspace package fails, unless the --ignore-workspace-root-check or -W flag is used.\nFor instance, pnpm add debug -W"
},
{
"names": [
"--global",
"-g"
],
"description": "Install a package globally"
},
{
"names": [
"--workspace"
],
"description": "Only adds the new dependency if it is found in the workspace"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "package",
"is_variadic": true
}
]
},
{
"name": "install",
"aliases": [
"i"
],
"description": "Pnpm install is used to install all dependencies for a project.\nIn a CI environment, installation fails if a lockfile is present but needs an update.\nInside a workspace, pnpm install installs all depe",
"args": [
{
"name": "package",
"is_variadic": true
}
]
},
{
"name": "update",
"aliases": [
"upgrade",
"up"
],
"description": "Pnpm update updates packages to their latest version based on the specified range.\nWhen used without arguments, updates all dependencies. You can use patterns to update specific dependencies",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Concurrently runs update in all subdirectories with a package.json (excluding node_modules)"
},
{
"names": [
"--latest",
"-L"
],
"description": "Ignores the version range specified in package.json. Instead, the version specified by the latest tag will be used (potentially upgrading the packages across major versions)"
},
{
"names": [
"--global"
],
"description": "Update global packages"
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Only update packages in dependencies and optionalDependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Only update packages in devDependencies"
},
{
"names": [
"--no-optional"
],
"description": "Don't update packages in optionalDependencies"
},
{
"names": [
"--interactive",
"-i"
],
"description": "Show outdated dependencies and select which ones to update"
},
{
"names": [
"--workspace"
],
"description": "Tries to link all packages from the workspace. Versions are updated to match the versions of packages inside the workspace.\nIf specific packages are updated, the command will fail if any of the update"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
}
]
},
{
"name": "remove",
"aliases": [
"rm",
"uninstall",
"un"
],
"description": "Removes packages from node_modules and from the project's package.json",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "When used inside a workspace, removes a dependency (or dependencies) from every workspace package.\nWhen used not inside a workspace, removes a dependency (or dependencies) from every package found in "
},
{
"names": [
"--global"
],
"description": "Remove a global package"
},
{
"names": [
"-P",
"--save-prod"
],
"description": "Only remove the dependency from dependencies"
},
{
"names": [
"-D",
"--save-dev"
],
"description": "Only remove the dependency from devDependencies"
},
{
"names": [
"--save-optional",
"-O"
],
"description": "Only remove the dependency from optionalDependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
}
]
},
{
"name": "unlink",
"description": "Unlinks a system-wide package (inverse of pnpm link).\nIf called without arguments, all linked dependencies will be unlinked.\nThis is similar to yarn unlink, except pnpm re-installs the dependency afte",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Unlink in every package found in subdirectories or in every workspace package, when executed inside a workspace"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
},
{
"template": "filepaths"
}
]
},
{
"name": "rebuild",
"aliases": [
"rb"
],
"description": "Rebuild a package",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "This command runs the pnpm rebuild command in every package of the monorepo"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Package",
"is_variadic": true
},
{
"template": "filepaths"
}
]
},
{
"name": "list",
"aliases": [
"ls"
],
"description": "This command will output all the versions of packages that are installed, as well as their dependencies, in a tree-structure.\nPositional arguments are name-pattern@version-range identifiers, which wil",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Perform command on every package in subdirectories or on every workspace package, when executed inside a workspace"
},
{
"names": [
"--json"
],
"description": "Log output in JSON format"
},
{
"names": [
"--long"
],
"description": "Show extended information"
},
{
"names": [
"--parseable"
],
"description": "Outputs package directories in a parseable format instead of their tree view"
},
{
"names": [
"--global"
],
"description": "List packages in the global install directory instead of in the current project"
},
{
"names": [
"--depth"
],
"description": "Max display depth of the dependency tree.\npnpm ls --depth 0 will list direct dependencies only. pnpm ls --depth -1 will list projects only. Useful inside a workspace when used with the -r option",
"takes_arg": true,
"arg": {
"name": "number"
}
},
{
"names": [
"--dev",
"-D"
],
"description": "Only list dev dependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only list production dependencies"
},
{
"names": [
"--no-optional"
],
"description": "Don't list optionalDependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
]
},
{
"name": "outdated",
"description": "Checks for outdated packages. The check can be limited to a subset of the installed packages by providing arguments (patterns are supported)",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Check for outdated dependencies in every package found in subdirectories, or in every workspace package when executed inside a workspace"
},
{
"names": [
"--long"
],
"description": "Print details"
},
{
"names": [
"--global"
],
"description": "List outdated global packages"
},
{
"names": [
"--no-table"
],
"description": "Prints the outdated dependencies in a list format instead of the default table. Good for small consoles"
},
{
"names": [
"--compatible"
],
"description": "Prints only versions that satisfy specifications in package.json"
},
{
"names": [
"--dev",
"-D"
],
"description": "Only list dev dependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only list production dependencies"
},
{
"names": [
"--no-optional"
],
"description": "Doesn't check optionalDependencies"
}
]
},
{
"name": "why",
"description": "Shows all packages that depend on the specified package",
"options": [
{
"names": [
"--recursive",
"-r"
],
"description": "Show the dependency tree for the specified package on every package in subdirectories or on every workspace package when executed inside a workspace"
},
{
"names": [
"--json"
],
"description": "Log output in JSON format"
},
{
"names": [
"--long"
],
"description": "Show verbose output"
},
{
"names": [
"--parseable"
],
"description": "Show parseable output instead of tree view"
},
{
"names": [
"--global"
],
"description": "List packages in the global install directory instead of in the current project"
},
{
"names": [
"--dev",
"-D"
],
"description": "Only display the dependency tree for packages in devDependencies"
},
{
"names": [
"--prod",
"-P"
],
"description": "Only display the dependency tree for packages in dependencies"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "run",
"aliases": [
"run-script"
],
"description": "Runs a script defined in the package's manifest file",
"options": [
{
"names": [
"-r",
"--recursive"
],
"description": "This runs an arbitrary command from each package's \"scripts\" object. If a package doesn't have the command, it is skipped. If none of the packages have the command, the command fails"
},
{
"names": [
"--if-present"
],
"description": "You can use the --if-present flag to avoid exiting with a non-zero exit code when the script is undefined. This lets you run potentially undefined scripts without breaking the execution chain"
},
{
"names": [
"--parallel"
],
"description": "Completely disregard concurrency and topological sorting, running a given script immediately in all matching packages with prefixed streaming output. This is the preferred flag for long-running proces"
},
{
"names": [
"--stream"
],
"description": "Stream output from child processes immediately, prefixed with the originating package directory. This allows output from different packages to be interleaved"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "exec",
"description": "Execute a shell command in scope of a project.\nnode_modules/.bin is added to the PATH, so pnpm exec allows executing commands of dependencies",
"options": [
{
"names": [
"-r",
"--recursive"
],
"description": "Execute the shell command in every project of the workspace.\nThe name of the current package is available through the environment variable PNPM_PACKAGE_NAME (supported from pnpm v2.22.0 onwards)"
},
{
"names": [
"--parallel"
],
"description": "Completely disregard concurrency and topological sorting, running a given script immediately in all matching packages with prefixed streaming output. This is the preferred flag for long-running proces"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
},
{
"name": "test",
"aliases": [
"t",
"tst"
],
"description": "Runs an arbitrary command specified in the package's test property of its scripts object.\nThe intended usage of the property is to specify a command that runs unit or integration testing for your prog"
},
{
"name": "publish",
"description": "Publishes a package to the registry.\nWhen publishing a package inside a workspace, the LICENSE file from the root of the workspace is packed with the package (unless the package has a license of its o",
"options": [
{
"names": [
"--tag"
],
"description": "Publishes the package with the given tag. By default, pnpm publish updates the latest tag",
"takes_arg": true,
"arg": {
"name": "<tag>"
}
},
{
"names": [
"--dry-run"
],
"description": "Does everything a publish would do except actually publishing to the registry"
},
{
"names": [
"--ignore-scripts"
],
"description": "Ignores any publish related lifecycle scripts (prepublishOnly, postpublish, and the like)"
},
{
"names": [
"--no-git-checks"
],
"description": "Don't check if current branch is your publish branch, clean, and up-to-date"
},
{
"names": [
"--access"
],
"description": "Tells the registry whether the published package should be public or restricted",
"takes_arg": true,
"arg": {
"name": "Type",
"suggestions": [
"public",
"private"
]
}
},
{
"names": [
"--force"
],
"description": "Try to publish packages even if their current version is already found in the registry"
},
{
"names": [
"--report-summary"
],
"description": "Save the list of published packages to pnpm-publish-summary.json. Useful when some other tooling is used to report the list of published packages"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
],
"args": [
{
"name": "Branch"
}
]
}
],
"options": [
{
"names": [
"--link-workspace-packages"
],
"description": "Link locally available packages in workspaces of a monorepo into node_modules instead of re-downloading them from the registry. This emulates functionality similar to yarn workspaces.\nWhen this is set",
"takes_arg": true,
"arg": {
"name": "bool or `deep`",
"suggestions": [
"dee["
]
}
},
{
"names": [
"--workspace-concurrency"
],
"description": "Set the maximum number of tasks to run simultaneously. For unlimited concurrency use Infinity",
"takes_arg": true,
"arg": {
"name": "<number>"
}
},
{
"names": [
"--bail"
],
"description": "Stops when a task throws an error"
},
{
"names": [
"--no-bail"
],
"description": "Don't stop when a task throws an error"
},
{
"names": [
"--sort"
],
"description": "Packages are sorted topologically (dependencies before dependents)"
},
{
"names": [
"--no-sort"
],
"description": "Disable packages sorting"
},
{
"names": [
"--reverse"
],
"description": "The order of packages is reversed"
},
{
"names": [
"--filter"
],
"description": "Filtering allows you to restrict commands to specific subsets of packages.\npnpm supports a rich selector syntax for picking packages by name or by relation.\nMore details: https://pnpm.io/filtering",
"takes_arg": true,
"arg": {
"name": "Filepath / Package",
"description": "To only select packages under the specified directory, you may specify any absolute path, typically in POSIX format",
"template": "filepaths"
}
}
]
},
{
"name": "server",
"description": "Manage a store server",
"subcommands": [
{
"name": "start",
"description": "Starts a server that performs all interactions with the store. Other commands will delegate any store-related tasks to this server",
"options": [
{
"names": [
"--background"
],
"description": "Runs the server in the background, similar to daemonizing on UNIX systems"
},
{
"names": [
"--network-concurrency"
],
"description": "The maximum number of network requests to process simultaneously",
"takes_arg": true,
"arg": {
"name": "number"
}
},
{
"names": [
"--protocol"
],
"description": "The communication protocol used by the server. When this is set to auto, IPC is used on all systems except for Windows, which uses TCP",
"takes_arg": true,
"arg": {
"name": "Type",
"suggestions": [
"auto",
"tcp",
"ipc"
]
}
},
{
"names": [
"--port"
],
"description": "The port number to use when TCP is used for communication. If a port is specified and the protocol is set to auto, regardless of system type, the protocol is automatically set to use TCP",
"takes_arg": true,
"arg": {
"name": "port number"
}
},
{
"names": [
"--store-dir"
],
"description": "The directory to use for the content addressable store",
"takes_arg": true,
"arg": {
"name": "Path",
"template": "filepaths"
}
},
{
"names": [
"--lock"
],
"description": "Set to make the package store immutable to external processes while the server is running or not"
},
{
"names": [
"--no-lock"
],
"description": "Set to make the package store mutable to external processes while the server is running or not"
},
{
"names": [
"--ignore-stop-requests"
],
"description": "Prevents you from stopping the server using pnpm server stop"
},
{
"names": [
"--ignore-upload-requests"
],
"description": "Prevents creating a new side effect cache during install"
}
]
},
{
"name": "stop",
"description": "Stops the store server"
},
{
"name": "status",
"description": "Prints information about the running server"
}
]
},
{
"name": "store",
"description": "Managing the package store",
"subcommands": [
{
"name": "status",
"description": "Checks for modified packages in the store.\nReturns exit code 0 if the content of the package is the same as it was at the time of unpacking"
},
{
"name": "add",
"description": "Functionally equivalent to pnpm add,\nexcept this adds new packages to the store directly without modifying any projects or files outside of the store"
},
{
"name": "prune",
"description": "Removes orphan packages from the store.\nPruning the store will save disk space, however may slow down future installations involving pruned packages.\nUltimately, it is a safe operation, however not re"
},
{
"name": "path",
"description": "Returns the path to the active store directory"
}
]
},
{
"name": "init",
"description": "Creates a basic package.json file in the current directory, if it doesn't exist already"
},
{
"name": "doctor",
"description": "Checks for known common issues with pnpm configuration"
}
],
"options": [
{
"names": [
"-C",
"--dir"
],
"description": "Run as if pnpm was started in <path> instead of the current working directory",
"takes_arg": true,
"arg": {
"name": "path",
"template": "folders"
}
},
{
"names": [
"-w",
"--workspace-root"
],
"description": "Run as if pnpm was started in the root of the <workspace> instead of the current working directory",
"takes_arg": true,
"arg": {
"name": "workspace"
}
},
{
"names": [
"-h",
"--help"
],
"description": "Output usage information"
},
{
"names": [
"-v",
"--version"
],
"description": "Show pnpm's version"
}
],
"args": [
{
"name": "Scripts",
"is_variadic": true
}
]
}