Installation

The CLI ships two ways: an npm package (needs Node 18+) and standalone tarballs that bundle their own Node runtime (no system Node required). The standalone builds back the Homebrew and curl installers.

npm

npm install -g @nexspace/cli
nexspace --version

Homebrew (macOS / Linux)

brew install nexspace365/tap/nexspace
# or
brew tap nexspace365/tap && brew install nexspace

curl (standalone)

curl -fsSL https://get.nexspace365.com/cli | bash

The install script detects your OS/arch, downloads the matching tarball from GitHub Releases, verifies its SHA256 against the release’s SHA256SUMS.txt, unpacks it to ~/.nexspace, and links nexspace onto your PATH. Re-running upgrades in place. Pin a version with --version cli-vX.Y.Z.

Manual download

Grab a tarball for your platform from the release assets (names embed the version and build sha, e.g. nexspace-v0.2.0-<sha>-darwin-arm64.tar.gz) and the SHA256SUMS.txt to verify it:

tar -xzf nexspace-*-darwin-arm64.tar.gz     # extracts a ./nexspace directory
sudo ln -sf "$PWD/nexspace/bin/nexspace" /usr/local/bin/nexspace

Updating

nexspace update            # standalone (Homebrew/curl) installs
brew upgrade nexspace      # Homebrew
npm i -g @nexspace/cli     # npm

The CLI also prints a one-line notice when a newer version is available.

Requirements

Node.js 18+ (npm install only — standalone builds bundle Node)
macOS 12+, Ubuntu 20.04+, or Windows 10+