Guardian CLI tool

Upgrade

Check your Guardian CLI version and upgrade to the latest signed release with guardian update, or with Homebrew or WinGet.

guardian update replaces your guardian with the latest signed release, and only when you run it. Nothing else updates the CLI.

Check your version

guardian version

To see whether a newer release exists without installing it:

guardian update --check

Upgrade

On macOS and Linux:

guardian update

On Windows, in PowerShell:

guardian update

Type y at the update guardian X -> Y? prompt. Then check the new version:

guardian version

Installed with Homebrew or WinGet

guardian update refuses a CLI installed with Homebrew or WinGet. Upgrade it with the same tool instead:

brew upgrade guardian
winget upgrade Guardian.CLI

In scripts and CI

Without a terminal, guardian update needs --yes:

guardian update --yes

In CI, install a pinned version instead. See Install the CLI.

If it refuses

guardian update refuses before it downloads anything when:

  • Your guardian is a dev build, not a release.
  • On macOS and Linux, your guardian is owned by another user, or it or its folder is writable by other users. Reinstall it with the Quick Start installer.

It only moves to a higher version, so it can't downgrade or reinstall the same one.

Before it replaces anything, it verifies the release signature and checksum. If a check fails, it changes nothing.