Metadata-Version: 2.4
Name: nexhelm
Version: 0.3.13
Summary: Nexhelm CLI (`nex`). Public client for Nexhelm AI — login, workspaces, workflows. No core IP; the backend is the boundary.
Author: Nexhelm
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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):

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

<details>
<summary>Already have a modern Python and prefer pipx?</summary>

```bash
pipx install nexhelm
```
</details>

## 2. Update

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

Force a clean reinstall if anything's off:

```bash
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

```bash
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.
