Skip to content

gram update

The update command updates the Gram CLI to the latest available version. It automatically detects your 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 you originally installed the CLI.

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 your installation method (Homebrew, Aqua, or manual)
  5. Uses the appropriate update mechanism for your installation

Installation Methods

Section titled “Installation Methods”

Homebrew (macOS/Linux):

  • Automatically runs brew upgrade gram
  • Recommended for most users on macOS and Linux

Aqua:

  • Automatically runs aqua upgrade speakeasy-api/gram/gram
  • Used when Gram was installed via the Aqua project 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 if you need to reinstall 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. You’ll need to rebuild from source or install a released version.

  • 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 Gram GitHub repository
  • The command respects system proxy settings if configured