missing-ag-updater 0.1.1

Auto-updater utility for Google Antigravity developer tools (IDE, Hub, CLI)

missing-ag-updater

[!IMPORTANT] Disclaimer: This project is an unofficial, community-maintained utility. It is NOT affiliated with, sponsored by, or supported by Google LLC.

[!WARNING] Alpha Software: This utility is currently in an early alpha stage of development. Features may change without notice, and bugs may occur. Use with caution.

This repository contains a Python utility to check for and apply updates to the Google Antigravity developer suite on Linux, macOS, and Windows.

Features

• Component Support: Independently check and upgrade:
  • Antigravity IDE (VS Code-based AI Editor)
  • Antigravity Hub (Standalone Agent Desktop Application)
  • Antigravity CLI (agy command line tool)
• Cross-Platform: Supports Linux (.tar.gz), macOS (.dmg mount installation), and Windows (.exe silent installation).
• Safe Installation: Warns if the target application is running before attempting to overwrite files.
• Verification: Downloads the CLI directly and verifies SHA512 checksums prior to installation.
• Rich Terminal UI: Displays download progress bars and clear success/warning logs.
• Dry Run Support: Check if any updates are available without changing any files.
• Development Tooling: Complete with linter, test coverage, and environment creation via uv.

Installation

For Users (via pipx)

The recommended way to install and run the tool in an isolated environment is via pipx:

# Install the stable release from PyPI (recommended):
pipx install missing-ag-updater

# Alternatively, install the development version directly from GitHub:
pipx install git+https://github.com/hellqvio86/missing-ag-updater.git

Once installed, the antigravity-updater command will be globally available.

For Developers

Create the local virtual environment and install development tools (pytest, ruff) using uv and the provided Makefile:

make venv

Usage

Run the package directly to check and update all components:

python -m missing_ag_updater
# or using the installed entrypoint:
antigravity-updater

Example Output

$ antigravity-updater

=== Unofficial Antigravity Applications Auto-Updater (missing-ag-updater) ===
⚠ This project is a community tool and is NOT affiliated with, sponsored by, or supported by Google.
  Target Platform: linux (x64)

⠋ Checking for Antigravity IDE updates...
  Local IDE Version:  2.0.4
  Latest IDE Version: 2.0.4
✓ Antigravity IDE is up to date.

⠋ Checking for Antigravity Hub updates...
  Local Hub Version:  2.1.4
  Latest Hub Version: 2.1.4
✓ Antigravity Hub is up to date.

⠋ Checking for Antigravity CLI updates...
  Local CLI Version:  1.0.8
  Latest CLI Version: 1.0.8
✓ Antigravity CLI is up to date.

✓ Operation completed successfully.

Options

usage: python -m missing_ag_updater [-h] [--check] [--ide] [--hub] [--cli] [--force]
                 [--dir-ide DIR_IDE] [--dir-hub DIR_HUB] [--path-cli PATH_CLI]

Auto-updater utility for Google Antigravity developer tools (Cross-Platform).

options:
  -h, --help         show this help message and exit
  --check            Check for available updates without installing (dry run)
  --ide              Update only the Antigravity IDE
  --hub              Update only the Antigravity Hub
  --cli              Update only the Antigravity CLI
  --force            Bypass version checks and active process warnings
  --dir-ide DIR_IDE  Override path to Antigravity IDE folder/bundle
  --dir-hub DIR_HUB  Override path to Antigravity Hub folder/bundle
  --path-cli PATH_CLI Override path to Antigravity CLI binary

Examples

• Dry run check for all tools:

  python -m missing_ag_updater --check
  

• Force update the Hub application only:

  python -m missing_ag_updater --hub --force
  

• Update only the CLI tool:

  python -m missing_ag_updater --cli
  

Launching the Applications

Once updated, you can launch the Antigravity tools using their standard terminal commands:

• Antigravity IDE (VS Code-based AI Editor):

  antigravity-ide
  

• Antigravity Hub (Standalone agent desktop application):

  antigravity
  

• Antigravity CLI (Terminal utility):

  agy
  

Development

The project includes a Makefile to simplify development tasks:

• Lint check (Ruff):

  make lint
  

• Run unit tests (Pytest):

  make test
  

• Clean virtual environment & cache:

  make clean
  

License

This project is licensed under the MIT License.