Skip to content

aube ci

  • Usage: aube ci [FLAGS]
  • Aliases: clean-install, ic, install-clean
  • Effect: modifies state

Clean install: delete node_modules, then install with frozen lockfile.

Use in CI to guarantee a reproducible install from the committed lockfile.

Flags

  • --ignore-scripts — Skip lifecycle scripts (no-op; aube already skips by default)
  • --no-optional — Skip optionalDependencies; don't install optional native modules
  • -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