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 ("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:

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

archivst help
archivst auth status

Exit code 0 from auth status means sign-in works; follow Headless authentication to store a token.

Update

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

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