|Docs

Install and update

Sume CLI is distributed as release binaries from the SumeLabs/sume-cli repository. The installer downloads the latest supported binary for your platform and verifies it by running sume --version.

macOS and Linux

Install the latest release:

Install a specific release:

After installation, verify:

Windows PowerShell

Then verify:

First run

Use sume login --no-browser --timeout 600 instead of plain sume login in remote/headless terminals. See Authentication.

Updates

Check for an update without installing it:

Install an available update:

Inspect the installed version and any known update:

Installed interactive binaries may also perform background update checks. Disable background checks when you need deterministic automation:

Manual sume update still works when background checks are disabled.

Package behavior

The CLI uses a local configuration directory, defaulting to:

Set SUME_CONFIG_DIR when a sandbox or CI job should use an isolated config:

For CI and other non-interactive environments, prefer SUME_API_KEY over an interactive login flow.