aube run

• Usage: aube run [FLAGS] [SCRIPT] [ARGS]…
• Aliases: run-script

Run a script defined in package.json

Arguments

• [SCRIPT] — Script or local binary name.

  Omit on an interactive TTY to pick from package.json scripts. If no script matches, aube falls back to node_modules/.bin/<name>.

• [ARGS]… — Arguments to pass to the script

Flags

• --if-present — Don't error if the script is missing from package.json

• --inspect[=[[HOST:]PORT]] — Forward --inspect to a Node-backed script or local binary.

• --inspect-brk[=[[HOST:]PORT]] — Forward --inspect-brk to a Node-backed script or local binary.

• --no-bail — Continue recursive execution after a script fails.

  Parsed for pnpm compatibility; aube's sequential fanout still stops on first failure.

• --no-install — Skip auto-install check

• --no-sort — Disable topological sorting (default is on).

  Without this, recursive runs visit packages in a deps-first order so a build script in a shared library finishes before a dependent app's build starts. Pass this to fall back to the raw workspace-listing order.

• --parallel — Run the script in every matched workspace package concurrently.

  Unbounded parallelism. Pair with --workspace-concurrency=N to cap the worker count. Single-package runs ignore this flag. First non-zero exit fails the whole run, but siblings are allowed to finish so their output isn't truncated. Child stdio is piped and lines are emitted with a <package>: prefix; pass --reporter-hide-prefix to drop the labels.

• --report-summary — Write a recursive run summary file.

  Parsed for pnpm compatibility.

• --reporter-hide-prefix — Hide the <package>: label on parallel-run output lines.

  Lines are still piped through aube (so the line breaks are clean even when many packages run at once), but the source package isn't named on each line. Sequential runs ignore this flag.

• --resume-from <PACKAGE> — Resume recursive execution starting at this package name.

  After the topo sort and --reverse are applied, packages before the named one in the resulting order are skipped. Errors if the name isn't in the matched workspace set.

• --reverse — Reverse the recursive execution order (after topo sort).

  Useful for teardown-style scripts where dependents must shut down before their deps.

• --sort — Sort recursive packages topologically (this is the default).

  Pass to override an earlier --no-sort on the same invocation.

• -s — Suppress aube's wrapper output while still showing script stdout/stderr.

  Short alias for the global --silent flag.

• --workspace-concurrency <N> — Cap the number of recursive packages running at once.

  Setting this implicitly enables parallel mode at width N. 0 means "use the available CPU count". Without this flag, --parallel stays unbounded.

• -h --help — Print help

Lockfile

• --frozen-lockfile — Error if the lockfile drifts from package.json.
• --no-frozen-lockfile — Always re-resolve, even if the lockfile is up to date.
• --prefer-frozen-lockfile — Use the lockfile when fresh, re-resolve when stale.

Network

• --fetch-retries <N> — Number of retry attempts for failed registry fetches.

  Overrides fetchRetries / fetch-retries from .npmrc / aube-workspace.yaml when set. Pair with --fetch-timeout to fail fast in scripted test runs.

• --fetch-retry-factor <N> — Exponential backoff factor between retry attempts.

  Overrides fetchRetryFactor / fetch-retry-factor from .npmrc / aube-workspace.yaml when set. Integer-only; fractional values like 1.5 are rejected.

• --fetch-retry-maxtimeout <MS> — Upper bound (ms) on the computed retry backoff.

  Overrides fetchRetryMaxtimeout / fetch-retry-maxtimeout from .npmrc / aube-workspace.yaml when set.

• --fetch-retry-mintimeout <MS> — Lower bound (ms) on the computed retry backoff.

  Overrides fetchRetryMintimeout / fetch-retry-mintimeout from .npmrc / aube-workspace.yaml when set.

• --fetch-timeout <MS> — Per-request HTTP timeout in milliseconds.

  Overrides fetchTimeout / fetch-timeout from .npmrc / aube-workspace.yaml when set. Covers the whole request (headers and body together).

• --registry <URL> — Override the default registry URL for this invocation.

  Use this npm registry URL for package metadata, tarballs, audit requests, dist-tags, and registry writes.

Virtual store

• --disable-global-virtual-store — Force the shared global virtual store off for this invocation.

  Packages are materialized inside the project's virtual store instead of symlinked from the shared tree under <cacheDir>/virtual-store/v1/ (by default ~/.cache/aube/virtual-store/v1/).

  Aliases: --disable-gvs

• --enable-global-virtual-store — Force the shared global virtual store on for this invocation.

  Overrides CI's default per-project materialization and the disableGlobalVirtualStoreForPackages auto-disable heuristic.

  Aliases: --enable-gvs