Skip to content
Platform Status

Technical Reference

gram update

The update command updates the gram CLI to the latest available version. It automatically detects the installation method (Homebrew, Aqua, or manual) and uses the appropriate update mechanism.

The gram update command supports multiple installation methods and will automatically use the right one based on how the CLI was originally installed.

Usage

Section titled “Usage”

Update to the latest version:

Terminal window
gram update

Check for updates without installing:

Terminal window
gram update --check

Force update even if already on the latest version:

Terminal window
gram update --force

How it works

Section titled “How it works”

The update command:

  1. Checks the current version of the gram CLI
  2. Fetches the latest release information from GitHub
  3. Compares versions to determine if an update is available
  4. Detects the installation method (Homebrew, Aqua, or manual)
  5. Uses the appropriate update mechanism for that installation

Installation methods

Section titled “Installation methods”

Homebrew (macOS/Linux):

  • Automatically runs brew upgrade speakeasy-api/tap/gram
  • Recommended for most users on macOS and Linux

Aqua:

  • Automatically runs aqua upgrade speakeasy-api/gram/gram
  • Used when the CLI was installed via the Aqua package manager

Manual installation:

  • Downloads the latest binary from GitHub releases
  • Replaces the current binary with the new version
  • Creates a backup of the old binary during the update process

Options

Section titled “Options”

—check

Section titled “—check”

Check for updates without installing them. This is useful for scripting or to see if an update is available.

Terminal window
gram update --check

Aliases: -c

—force

Section titled “—force”

Force an update even if the CLI is already on the latest version. This can be useful when reinstalling the current version.

Terminal window
gram update --force

Examples

Section titled “Examples”

Check if an update is available:

Terminal window
$ gram update --check
→ Update available: 0.9.12 → 0.9.13

Update to the latest version:

Terminal window
$ gram update
📦 Updating manually to version 0.9.13...
✓ Successfully updated gram CLI to version 0.9.13
  Run 'gram --version' to verify the new version

Update via Homebrew:

Terminal window
$ gram update
🍺 Updating via Homebrew...
✓ Successfully updated gram CLI via Homebrew
  Run 'gram --version' to verify the new version

Notes

Section titled “Notes”

Development builds (version “dev”) cannot be updated using this command. Rebuild from source or install a released version instead.

  • The update command requires internet access to check for and download new versions
  • For manual installations, the command creates a backup of the current binary before updating
  • Updates are fetched from the official GitHub releases of the speakeasy-api/gram repository