Install the CLI

The nca CLI lets you sign in from a terminal, list agents, inspect runtimes, and connect local machines. It is distributed as a standalone binary, so you do not need Node.js for normal use.

macOS and Linux

curl -fsSL https://cdn1.netmind.xyz/cli/install.sh | sh

The installer places nca in ~/.local/bin by default. If your shell cannot find it, add this to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

You can choose a different install directory:

NCA_INSTALL_DIR=/usr/local/bin curl -fsSL https://cdn1.netmind.xyz/cli/install.sh | sh

You may need sudo for system directories such as /usr/local/bin.

Windows

Download the Windows zip from the manual download path below, extract nca.exe, and place it in a directory on your PATH.

Manual download

Download a tarball or zip from:

https://cdn1.netmind.xyz/cli/v<version>/

The latest version string is published at:

https://cdn1.netmind.xyz/cli/latest/version.txt

platform	asset
linux-x64	`nca-<ver>-linux-x64.tar.gz`
linux-arm64	`nca-<ver>-linux-arm64.tar.gz`
macos-x64 (Intel)	`nca-<ver>-darwin-x64.tar.gz`
macos-arm64 (Apple)	`nca-<ver>-darwin-arm64.tar.gz`
windows-x64	`nca-<ver>-windows-x64.zip`

Each tarball ships with a sibling .sha256 for verification.

nca login
nca whoami

nca login opens a browser-based sign-in flow. If you are on a remote server or cannot launch a browser automatically, run:

nca login --no-launch-browser

The CLI prints a URL and waits for the authorization code.

Useful commands

nca agent list
nca runtime list
nca update --check

Agent creation and richer workspace actions are easiest from the web app. Use the CLI when you want terminal access, automation, or local machine registration.

Update

nca update --check
nca update