@bext-stack/cli

Thin wrapper around the bext native CLI binary. On first invocation, lazily downloads the right binary for your platform from GitHub releases and caches it under ~/.cache/bext-stack-cli/<version>/.

Install

npm  i -g @bext-stack/cli
bun  add -g @bext-stack/cli
pnpm add -g @bext-stack/cli
yarn global add @bext-stack/cli
# or one-shot
npx  @bext-stack/cli --help
bunx @bext-stack/cli --help

Usage

bext run          # auto-detect framework, build, serve
bext dev          # dev mode with file watching
bext build        # build the SSR bundle for production
bext deploy       # build + swap
bext cache purge  # purge the cache
bext health       # platform health check

See bext --help for the full command list.

How it works

The first time you run bext, the shim downloads bext-<version>-<platform>-<arch> from the matching GitHub release and caches it under ~/.cache/bext-stack-cli/<version>/bext. Subsequent runs exec the cached binary directly. No postinstall hook is required — Bun's global installer skips those, and this design works uniformly across npm/bun/pnpm/yarn.

If postinstall does run (npm with scripts enabled), it prefetches the binary into packages/cli/vendor/bext, which the shim uses as a preferred location.

Supported platforms

• linux-x64, linux-arm64
• darwin-x64, darwin-arm64
• win32-x64

Overrides

• BEXT_CLI_BINARY=/path/to/bext — use a local binary, skip lookup and download.
• BEXT_CLI_CACHE_DIR=/custom/path — override the cache directory.
• BEXT_CLI_SKIP_DOWNLOAD=1 — skip the opportunistic postinstall download (useful in CI images that already have bext on PATH).

License

MIT — Part of the bext stack.