Skip to content

aube exec

  • Usage: aube exec [FLAGS] <BIN> [ARGS]…
  • Aliases: x

Execute a locally installed binary

Arguments

  • <BIN> — Binary name
  • [ARGS]… — Arguments to pass to the binary

Flags

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

    Parsed for pnpm compatibility; aube currently stops on the first failure.

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

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

    Without this, recursive execs visit packages in a deps-first order. Pass this to fall back to raw workspace-listing order.

  • --parallel — Run recursive workspace executions concurrently.

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

    Parsed for pnpm compatibility.

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

    Lines are still piped (clean line breaks even with concurrent children) but the source package isn't named on each line. Sequential execs ignore this flag.

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

    Packages before the named one in the post-sort, post-reverse order are skipped. Errors if the name isn't in the matched set.

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

  • -c --shell-mode — Run the command through sh -c.

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

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

  • --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

MIT LicensejdxCopyright © 2026 jdx.dev