---
title: Install and update
description: Install or run the Sume CLI for current developer-platform workflows.
---

The recommended public install path is the hosted installer for the native
[`sumelabs/cli`](https://github.com/sumelabs/cli) binary. The binary is the
`sume.com` developer-platform CLI for `api.sume.com` workflows.

## Install on macOS or Linux

```bash
curl https://cli.sume.com/install -fsS | bash
```

The installer downloads the latest release binary for your OS and architecture,
verifies it against `checksums.txt`, and installs `sume` under
`~/.sume-com/bin` without silently overwriting a different `sume` already found
on your `PATH`.

## Install on Windows PowerShell

```powershell
irm https://cli.sume.com/install.ps1 | iex
```

## Direct GitHub binary fallback

The current release assets are named `sume-darwin-arm64`, `sume-darwin-x64`,
`sume-linux-arm64`, `sume-linux-x64`, and `sume-windows-x64.exe`, with
`checksums.txt` attached to each GitHub Release. For pinned installs, replace
`latest` in the URL with a release tag such as `v0.1.6`.

```bash
OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
ARCH="$(uname -m | sed 's/x86_64/x64/;s/aarch64/arm64/')"
curl -fsSL "https://github.com/sumelabs/cli/releases/latest/download/sume-${OS}-${ARCH}" -o /tmp/sume
chmod +x /tmp/sume
sudo mv /tmp/sume /usr/local/bin/sume
```

## Sign in

Use browser login for the default auth flow:

```bash
sume login
sume auth status
```

For remote or headless environments:

```bash
sume login --no-browser
```

Manual API-key setup remains available for CI and controlled server
environments, but it is not the recommended first-run path for local users.

## Development build

From the CLI source repository:

```bash
pnpm install
pnpm run build
pnpm dev -- --help
```

Build a local binary when needed:

```bash
pnpm run build:binary
./dist/sume --version
```

## Verify

```bash
sume version
sume doctor --agent --json
sume update --check
```

`sume update --check` reports whether a newer GitHub Release exists without
modifying local files. Re-run the hosted installer when you choose to upgrade.