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.

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

--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 — the underlying FetchPolicy.retry_factor is u32. Fractional values like 1.5 are rejected by clap.

--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. Applied via reqwest's .timeout() so it covers headers + 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.

--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 ~/.cache/aube/virtual-store/.

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