missing-ag-updater 0.1.0

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)

You can install the tool globally into an isolated virtual environment using pipx:

# Install directly from the GitHub repository:
pipx install git+https://github.com/hellqvio86/missing-ag-updater.git

# Or install from PyPI (once published):
pipx install missing-ag-updater

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

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.