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
guardianis adevbuild, not a release. - On macOS and Linux, your
guardianis 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.