> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nexspace365.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the NexSpace CLI

# 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

```bash theme={null}
npm install -g @nexspace/cli
nexspace --version
```

## Homebrew (macOS / Linux)

```bash theme={null}
brew install nexspace365/tap/nexspace
# or
brew tap nexspace365/tap && brew install nexspace
```

## curl (standalone)

```bash theme={null}
curl -fsSL https://get.nexspace365.com/cli | bash
```

The install script detects your OS/arch, downloads the matching tarball from
[GitHub Releases](https://github.com/Nexspace365/NexSpace/releases?q=cli),
**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:

```bash theme={null}
tar -xzf nexspace-*-darwin-arm64.tar.gz     # extracts a ./nexspace directory
sudo ln -sf "$PWD/nexspace/bin/nexspace" /usr/local/bin/nexspace
```

## Updating

```bash theme={null}
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+