# Native CLI install

The CLI is a self-contained .NET 10 executable that runs standalone — no installer and no global install required. Download the binary for the machine, place it somewhere the process can read/write from, and invoke it by full path (or add the directory to `PATH`).

## Obtain the binary

- **Windows / macOS / Linux** — from the site's [account downloads page](/identity/account/manage/apps) ("CLI binary", platform buttons). The link resolves to `/Installers?blob=<name>` and redirects to a short-lived SAS URL; the link is only usable while signed in, and each user may download once per day
- **Linux via terminal** — the latest release endpoint (`/api/cli/linux?arch=x64` or `?arch=arm64`) streams the binary directly, but it requires a signed-in site session:

  ```bash
  # -b passes the session cookie from a signed-in browser
  curl -L -f -b "<session-cookie>" -o archivst "https://<site>/api/cli/linux?arch=x64"
  chmod +x archivst
  ```

  Downloads are limited to one per user per day. The server prefers `.deb` then `.rpm` then `.zip` for the matching architecture.

The downloaded binary is `Archivst.CLI.exe` (Windows) or `Archivst.CLI`. Rename it to `archivst` if you want the commands used on the other pages to work verbatim.

## Verify the install

```console
archivst help
archivst auth status
```

Exit code `0` from `auth status` means sign-in works; follow [Headless authentication](/agentic/auth) to store a token.

## Update

Once the CLI is on the machine, updates are managed by the CLI itself (sign-in required):

```bash
archivst update --check          # compare current vs latest, no download
archivst update --apply --yes    # download and replace in place
archivst update --version 1.2.3  # pin a specific version
```

`update` resolves the latest version from the site (`/version`, `/min-version`) and downloads a single-file asset for the current platform from the Archivst storage container. If no asset is found it reports which platform was searched so you can fall back to the downloads page.

[Back to Agentic Usage](/agentic)