`scpm`

Usage: scpm [FLAGS] <SUBCOMMAND>

Version: 1.17.1

Usage: scpm [FLAGS] <SUBCOMMAND>

Global Flags

`-C --dir <DIR>`

Change to directory before running (like make -C or mise --cd)

`-F --filter… <PATTERN>`

Scope command execution to workspace packages matching PATTERN.

Supports exact names (my-pkg), globs (@scope/*, *-plugin), paths (./packages/api), graph selectors (pkg..., ...pkg), git-ref selectors ([origin/main]), and exclusions (!pkg). Repeatable; matches are OR-ed.

Currently honored by run, test, start, stop, restart, install, exec, list, publish, deploy, add, remove, update, why, and implicit-script invocations.

`-r --recursive`

Run the command across every workspace package.

Equivalent to --filter=*; if --filter is also given, --recursive is a no-op and the explicit filter wins. Honored by the same commands as --filter.

`-v --verbose`

Enable verbose/debug logging (shortcut for --loglevel debug)

`-V --version`

Print version and check for updates.

Manual flag so we can run the async update notifier alongside the version print — clap's auto Action::Version exits inside parse_from, before the tokio runtime is built.

`--color`

Force colored output even when stderr is not a TTY.

Overrides NO_COLOR / CLICOLOR=0. Mutually exclusive with --no-color.

`--diag <MODE>`

Enable cold-install deep diagnostics. Modes: summary — sum_ms / mean / max / %wall table at end trace — summary + critical path + starvation + what-if + lifecycle live — like trace, plus print every span >= 100ms to stderr live full — like trace, plus write JSONL trace to a file (defaults to ./scpm-diag.jsonl)

Quick form: --diag with no value defaults to trace. Output file path can be set via --diag-file. Threshold for live mode via --diag-threshold-ms.

`--diag-file <PATH>`

Path for --diag full JSONL trace (default: ./scpm-diag.jsonl)

`--diag-threshold-ms <MS>`

Live-mode threshold: only print spans whose duration is >= N ms (default 100)

`--fail-if-no-match`

Error when a workspace selector matches no packages.

Accepted globally; selected commands already fail on empty matches.

`--filter-prod… <PATTERN>`

Production-only variant of --filter.

Same selector grammar as --filter, but graph walks (pkg..., ...pkg) only follow dependencies / optionalDependencies / peerDependencies edges — devDependencies (and packages reachable solely through them) are skipped. Non-graph forms (exact name, glob, path, [git-ref]) behave identically to --filter. Repeatable; can be combined with --filter.

`--loglevel <LEVEL>`

Set the log level. Logs at or above this level are shown

Choices:

trace
debug
info
warn
error
silent

`--no-color`

Disable colored output.

Overrides FORCE_COLOR / CLICOLOR_FORCE and sets NO_COLOR=1 so downstream libraries (miette, clx, child processes) all see the same choice.

`--reporter <NAME>`

Output format: default, append-only, ndjson, silent.

default renders the progress UI when stderr is a TTY; append-only disables the progress UI in favor of plain line-at-a-time logs; ndjson swaps the tracing fmt layer for the JSON formatter (one JSON object per log event on stderr) and is what tooling wrappers should consume; silent suppresses all non-error output (alias for --loglevel silent).