Speakeasy Logo
Skip to Content
Gram DocumentationCommand Linegram update

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

Update to the latest version:

gram update

Check for updates without installing:

gram update --check

Force update even if already on the latest version:

gram update --force

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

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

—check

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

gram update --check

Aliases: -c

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

gram update --force

Examples

Check if an update is available:

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

Update to the latest version:

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

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

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

Last updated on