CLI: Global Options

See the Getting Started or Glossary pages for more starting info.

Stale workspace data: Note that you need to run your package manager's install for pacwich to have current workspace data available, e.g. via bun install, pnpm install, or npm install. If you've added/removed/updated any workspace package.json, you'll likely need to run this again.

See also all CLI commands here or the CLI quick start.

All Global Options

Working Directory

Usage: --cwd | -d

Description: Get the project root from a specific directory. This should be where the root package.json of your project is located.

Examples:
pacwich --cwd=/path/to/your/project list-workspaces
pacwich -d /path/to/your/project list-workspaces

Package Manager

Usage: --pm

Values: autobunpnpmnpm

Description: Expect a specific package manager. This overrides config and environment variable settings.

Examples:
pacwich --pm=pnpm list-workspaces

Include Root

Usage: --include-root | -r

Description: Include the root workspace as a normal workspace. This overrides config and environment variable settings.

Examples:
pacwich --include-root list-workspaces
pacwich -r list-workspaces

pacwich --no-include-root list-workspaces # disable (to override config/env)

See more on the Root Workspace.


Disable Executable Configs

Usage: --disable-executable-configs

Description: Disable loading of executable config files (written in TS/JS) for untrusted contexts. This can be set by default using the environment variable PACWICH_DISABLE_EXECUTABLE_CONFIGS_DEFAULT=true.

Examples:
pacwich --disable-executable-configs list-workspaces

Suppress Warnings

Usage: --suppress-warnings

Description: Suppress warning logs by id, in addition to the PACWICH_SUPPRESS_WARNINGS env var

Examples:
pacwich --suppress-warnings=MissingWorkspacesHint,MultipleConfigsFound ls

See the warning page for a list of all IDs and means of setting suppression.


Log Level

Usage: --log-level | -l

Values: debuginfowarnerrorsilent

Default Value: info

Description: Set the logging level. For the run-script (run) command, silence output with --output-style=none. A default can be set with the PACWICH_LOG_LEVEL env var, which this flag overrides when passed.

Examples:
pacwich --log-level=debug list-workspaces
pacwich -l error list-workspaces