nexhelm 0.3.13

Nexhelm CLI (`nex`). Public client for Nexhelm AI — login, workspaces, workflows. No core IP; the backend is the boundary.

nexhelm

nex — the Nexhelm engineer CLI. One command takes you from nothing to a ready-to-code cloud workspace (a sealed per-firm "silo") open in your local VS Code over a secure tunnel. No repo clone, no SSH setup, no manual config.

Access is by GitHub organization membership — any member of the NexhelmAI org can sign in. No @nexhelm.ai email and no pre-existing account required.

---

1. Install

Use uv — it brings its own modern Python, so it works on any laptop (even old or no system Python, where pipx fails):

curl -LsSf https://astral.sh/uv/install.sh | sh    # one-time, if you don't have uv
uv tool install nexhelm

Already have a modern Python and prefer pipx?

pipx install nexhelm

2. Update

nex update                 # update to the latest release (uv or pipx)

Force a clean reinstall if anything's off:

uv tool install --force nexhelm
# or: pipx install --force nexhelm

3. VS Code

nex workspace enter opens your workspace in local VS Code, so VS Code must be on the machine. You don't have to install it yourself — if code isn't found, nex installs VS Code automatically (macOS / Linux / Windows). To set it up manually instead, get it from https://code.visualstudio.com/download.

---

Use it

nex login                              # GitHub sign-in (org membership = access)
nex workspace enter --customer <name>  # opens VS Code into the firm's silo

enter does everything for you: installs VS Code if missing, installs the Remote-SSH + Codex extensions, clones the repo, opens a window named nex.<name>, and waits until the code is actually there before opening.

• Omit --customer for a fresh throwaway dev workspace.
• Pass a stable --customer <name> to return to the same workspace later (durable per-firm silo; compute sleeps when idle, your work persists).

Run nex --help for the full command list.