buildwithnexusv0.12.2
Menu

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

PlatformSupport
Linuxx86_64, aarch64 (prebuilt)
macOSIntel, Apple Silicon (prebuilt)
Windowsx86_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:

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.