CLI Global Options

Run the CLI via bunx bun-workspaces or alias it to bw, such as via alias bw="bunx bun-workspaces", which can be placed in your shell configuration file, like .bashrc, .zshrc, or similar.

Examples use an implied bw alias for brevity instead of bunx bun-workspaces.

See the Glossary for more fundamental concepts.

Required Bun version: ^1.2.x


Global options should come before any commands.

Working Directory

Usage: --cwd | -d

Default Value: .

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

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

Log Level

Usage: --log-level | -l

Values: debuginfowarnerrorsilent

Default Value: info

Set the logging level. Script output of workspaces is always preserved, except when log level is set to "silent".

Examples:
bw --log-level=silent list-workspaces
bw -l error list-workspaces

Config File

DEPRECATED: Use the new workspace configuration instead to configure workspace aliases.

Usage: --config-file | -c

Use this option to point to a config file. Otherwise, ./bw.json is used by default.

Examples:
bw --config-file=/path/to/your/config.json list-workspaces
bw -c /path/to/your/config.json list-workspaces

© 2026 Smorsic Labs, LLC. All rights reserved.