ReferenceCLI
Upgrade
Reference for goodmem upgrade: Upgrade the GoodMem CLI to the latest version by downloading and installing the newest release from GitHub.
goodmem upgrade
Upgrade GoodMem CLI to the latest version
Synopsis
Upgrade the GoodMem CLI to the latest version by downloading and installing the newest release from GitHub. The upgrade process includes SHA-256 archive verification, cross-platform binary extraction, atomic replacement with backup, and automatic rollback on failure. Supports Windows executables and symlink installations.
goodmem upgrade [flags]Examples
# Upgrade to the latest version (with interactive confirmation)
goodmem upgrade
# Check if update is available (CI-friendly, exits 1 if available)
goodmem upgrade --check
# Upgrade automatically without confirmation (for scripts)
goodmem upgrade --yes
# Show what would be done without actually upgrading
goodmem upgrade --dry-run
# Target a specific release tag instead of latest
goodmem upgrade --tag v1.4.0
# Air-gapped upgrade: install a local tarball, SLSA-verified against its bundle
goodmem upgrade --local-cli-tarball goodmem-linux-amd64.tar.gz \
--local-bundle goodmem-linux-amd64.tar.gz.build.slsa --yes
# Combine flags for automated CI upgrades
goodmem upgrade --check && goodmem upgrade --yesOptions
--check Only check if update is available (exit 0 if up-to-date, 1 if update available)
--dry-run Show upgrade plan without downloading or installing
-h, --help help for upgrade
--local-bundle string Path to the local SLSA provenance bundle (goodmem-<os>-<arch>.tar.gz.build.slsa) matching --local-cli-tarball. When both are given, the local tarball is SLSA-verified against this bundle (same trust anchors as a get.goodmem.ai download) before install, instead of skipping verification. Requires --local-cli-tarball.
--local-cli-tarball string Install CLI from a local goodmem-<os>-<arch>.tar.gz instead of downloading. Bypasses the version check; SLSA verification is skipped unless --local-bundle is also given. Intended for network-restricted environments where get.goodmem.ai is unreachable.
--tag string Target specific release tag instead of latest (e.g., 'v1.4.0') (default "latest")
-y, --yes Skip interactive confirmation prompt (useful for automation)Options inherited from parent commands
--api-key string API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
--server string GoodMem server address (gRPC API)SEE ALSO
- goodmem - GoodMem CLI provides command-line access to memory APIs