Install
One command, zero install scripts. The prebuilt binary for your platform ships as a per-platform optional dependency and is verified end-to-end.
npm install -g buildwithnexus
buildwithnexus # or the short alias:
bwn
Requirements
| Platform | Support |
|---|---|
| Linux | x86_64, aarch64 (prebuilt) |
| macOS | Intel, Apple Silicon (prebuilt) |
| Windows | x86_64 (prebuilt) |
| Node.js | ≥ 18 (for the npm wrapper only) |
Auto-updates
Once installed, buildwithnexus keeps itself current: at most once a day a detached background process checks npm and silently installs newer versions — the next launch prints a one-line notice. Startup never waits on the network.
# opt out of auto-updates
export BWN_NO_AUTO_UPDATE=1
Package security
The npm package is built to come up clean on supply-chain scanners:
- No install scripts — nothing runs during
npm install. - No bundled sources or blobs — the main package is a few KB of readable
JavaScript; binaries ship as per-platform packages (like esbuild) selected by
os/cpu. - Verified binaries — release assets are SHA-256-checked when packaged and
carry build-provenance attestations (
gh attestation verify). - No eval, no minification, no network code in the wrapper — update checks run inside the CLI itself, not the npm package.
Installing with --omit=optional skips the platform binary —
point BWN_BIN at a binary you built or downloaded yourself.
cargo install
With a Rust toolchain, install straight from crates.io (API docs on docs.rs):
cargo install buildwithnexus # installs `buildwithnexus` + the `bwn` alias
cargo install bwn # short-name alias crate
Build from source
git clone https://github.com/Garretts-Apps/buildwithnexus
cd buildwithnexus
cargo build --release --manifest-path harness/Cargo.toml
First launch runs setup: pick a provider, model, and permission level.
Re-run anytime with bwn init.