Skip to content

aube dlx

  • Usage: aube dlx [FLAGS] [PARAMS]…

Fetch a package into a throwaway environment and run its binary

Arguments

  • [PARAMS]… — Command (binary) to run, followed by arguments to pass through to it.

    The first positional is the command; the rest are forwarded verbatim to the binary. Without --package, a local node_modules/.bin/<command> wins when present; otherwise dlx installs into a throwaway project. Under --shell-mode/-c the positionals are joined and evaluated by sh -c instead of looked up directly.

Flags

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

    <scratch>/node_modules/.bin is prepended to PATH. Use this for pipelines, redirects, or env expansion (aube dlx -p cowsay -c 'cowsay hello | tr a-z A-Z'). Mirrors pnpm dlx --shell-mode.

  • -p --package <PACKAGE> — Install a specific package (repeatable).

    Overrides inferring from the command.

  • --allow-build=<PKG> — Allow named packages to run lifecycle scripts during the transient install. Use --allow-build=<pkg>.

    Repeatable — pass once per package. The named package's preinstall / install / postinstall scripts execute during the transient install. Requires the equals form (--allow-build=<pkg>); space-separated forms are rejected. Mirrors pnpm's pnpm dlx --allow-build=<pkg> compatibility surface while keeping dlx scripts skipped unless explicitly approved.

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