Runtime Manual/Ecosystem & Tooling/Dynamic Package Runner (bee x / bee dlx)

Dynamic Package Runner (bee x / bee dlx)

Execute remote npm packages and CLI tools instantly with content-addressable cache and sandbox limits

1. What is bee x / bee dlx?

Similar to npx or bunx, bee x (aliased as bee dlx) lets developers run CLI executables from remote npm packages without running npm install, without polluting project node_modules, and without modifying package.json.

Unlike traditional tools, bee x is implemented natively in Rust with three key optimizations:

  1. Concurrent Streaming Download & Unpack: Directly streams tarballs from the registry and extracts to cache via fast async pipelines.
  2. Content-Addressable Global Cache: Cached under ~/.beejs/x_cache. Consecutive runs of the same version execute in sub-millisecond time.
  3. Native V8 Execution & Sandboxing: Inspects the bin field of package.json and runs directly on bee run, with support for timeout and memory caps.

2. Command Syntax & Examples

code
# Basic syntax
bee x <package-specifier> [arguments...]

# The dlx alias is also supported
bee dlx cowsay "Hello Beejs!"

Specifying Versions & Scopes

code
# 1. Run the latest version
bee x cowsay "Hello Beejs!"

# 2. Specify exact version
bee x prettier@3.2.5 --write "src/**/*.ts"

# 3. Scoped packages
bee x @biomejs/biome check ./src

# 4. Multi-binary packages
bee x typescript tsc --init

3. Sandboxing & CLI Options

bee x inherits the Beejs security philosophy, allowing safe execution of untrusted scripts:

code
# Cap execution time to 10 seconds
bee x --timeout 10000 untrusted-script

# Cap V8 heap memory to 128MB
bee x --max-memory 134217728 heavy-cli-tool

# Bypass local cache and fetch latest
bee x --no-cache cowsay "Always Fresh"

CLI Flag Reference

FlagShortDescriptionDefault
--timeout <ms>-tMaximum execution timeout in millisecondsUnlimited
--max-memory <bytes>-mMaximum V8 heap size in bytesUnlimited
--no-cacheSkip ~/.beejs/x_cache and force downloadfalse
--registry <url>Custom npm registry mirror URLnpmjs.org

4. CI/CD Pipeline Benefits

In GitHub Actions or containerized build pipelines, bee x eliminates heavy npm install steps, reducing one-off tool runs and scaffolding setup times from tens of seconds to hundreds of milliseconds:

code
# Direct tool invocation in CI
bee x eslint src/
bee x rimraf dist/
PreviousModern Standard Library (bee:std)NextDeployment & Containerization (bee deploy)