GoodMemGoodMem
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 --yes

Options

      --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