code-aide 1.15.7__tar.gz → 1.16.1__tar.gz

{code_aide-1.15.7 → code_aide-1.16.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: code-aide
-Version: 1.15.7
-Summary: Manage AI coding CLI tools (Claude, Copilot, Cursor, Gemini, Amp, Codex)
+Version: 1.16.1
+Summary: Manage AI coding CLI tools (Claude, Antigravity, Copilot, Cursor, Gemini, Amp, Codex)
 Project-URL: Homepage, https://github.com/dajobe/code-aide
 Project-URL: Repository, https://github.com/dajobe/code-aide
 Project-URL: Issues, https://github.com/dajobe/code-aide/issues
@@ -30,7 +30,8 @@ Description-Content-Type: text/markdown
 An aide for your AI coding tools.
 
 Manages installation, upgrade, removal, and version tracking of AI coding CLI
-tools: Claude Code, Copilot, Cursor, Gemini, Amp, Codex, OpenCode, and Kilo.
+tools: Claude Code, Antigravity, Copilot, Cursor, Gemini, Amp, Codex, OpenCode,
+and Kilo.
 
 ## Installation
 
@@ -58,7 +59,7 @@ code-aide status
 code-aide status -l
 
 # Install specific tools
-code-aide install claude gemini
+code-aide install claude antigravity
 
 # Install all default tools
 code-aide install
@@ -83,15 +84,19 @@ code-aide update-versions -y
 
 | Tool                     | Command    | Install Type    | Default |
 |:-------------------------|:-----------|:----------------|:--------|
-| Cursor CLI               | `agent`    | Direct download | Yes     |
+| Cursor CLI               | `agent`    | Direct download | No      |
 | Claude CLI (Claude Code) | `claude`   | Script          | Yes     |
-| Gemini CLI               | `gemini`   | npm             | Yes     |
+| Antigravity CLI          | `agy`      | Script          | Yes     |
+| Gemini CLI               | `gemini`   | npm             | No      |
 | OpenCode                 | `opencode` | npm             | No      |
 | Kilo CLI                 | `kilo`     | npm             | No      |
 | Amp (Sourcegraph)        | `amp`      | Script          | No      |
 | Codex CLI                | `codex`    | npm             | No      |
 | Copilot CLI              | `copilot`  | npm             | No      |
 
+Command aliases are also accepted: `agy` resolves to `antigravity`, and `agent`
+resolves to `cursor`.
+
 ## How Version Data Works
 
 code-aide uses a two-layer version data model:
@@ -113,29 +118,32 @@ Each entry in `tools.json` describes one managed tool. Required fields are
 `name`, `command`, and `install_type`; the others are optional and only
 consulted when the relevant install method or platform applies.
 
-| Field                         | Required | Notes                                                                                        |
-|:------------------------------|:---------|:---------------------------------------------------------------------------------------------|
-| `name`                        | Yes      | Display name for status output                                                               |
-| `command`                     | Yes      | Binary name (looked up in `PATH`)                                                            |
-| `install_type`                | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
-| `version_args`                | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
-| `version_url`                 | No       | URL queried by `update-versions` to discover the latest upstream version                     |
-| `latest_version`              | Cache    | Last known upstream version (filled by `update-versions`)                                    |
-| `latest_date`                 | Cache    | Release date for `latest_version`                                                            |
-| `prerequisites`               | No       | List of required external commands (e.g. `["npm"]`)                                          |
-| `min_node_version`            | No       | Minimum major Node.js version required                                                       |
-| `npm_package`                 | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
-| `install_url`                 | script   | URL of the install script that will be downloaded and piped to `bash`                        |
-| `install_sha256`              | script   | SHA-256 of the install script body — required for verified installs                          |
-| `install_script_path_prepend` | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
-| `download_url_template`       | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
-| `install_dir`                 | direct   | Directory to extract into; supports `{version}`                                              |
-| `bin_dir`                     | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
-| `symlinks`                    | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
-| `freebsd_port`                | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
-| `freebsd_pkg_repo`            | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
-| `next_steps`                  | No       | Free-form text printed after a successful install                                            |
-| `docs_url`                    | No       | Documentation URL printed after install                                                      |
+| Field                           | Required | Notes                                                                                        |
+|:--------------------------------|:---------|:---------------------------------------------------------------------------------------------|
+| `name`                          | Yes      | Display name for status output                                                               |
+| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                            |
+| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                  |
+| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
+| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
+| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                     |
+| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                      |
+| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                    |
+| `latest_date`                   | Cache    | Release date for `latest_version`                                                            |
+| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                          |
+| `min_node_version`              | No       | Minimum major Node.js version required                                                       |
+| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
+| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                        |
+| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                          |
+| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
+| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
+| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                              |
+| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
+| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
+| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
+| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
+| `next_steps`                    | No       | Free-form text printed after a successful install                                            |
+| `docs_url`                      | No       | Documentation URL printed after install                                                      |
+| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                       |
 
 ## Features
 

{code_aide-1.15.7 → code_aide-1.16.1}/README.md

@@ -3,7 +3,8 @@
 An aide for your AI coding tools.
 
 Manages installation, upgrade, removal, and version tracking of AI coding CLI
-tools: Claude Code, Copilot, Cursor, Gemini, Amp, Codex, OpenCode, and Kilo.
+tools: Claude Code, Antigravity, Copilot, Cursor, Gemini, Amp, Codex, OpenCode,
+and Kilo.
 
 ## Installation
 
@@ -31,7 +32,7 @@ code-aide status
 code-aide status -l
 
 # Install specific tools
-code-aide install claude gemini
+code-aide install claude antigravity
 
 # Install all default tools
 code-aide install
@@ -56,15 +57,19 @@ code-aide update-versions -y
 
 | Tool                     | Command    | Install Type    | Default |
 |:-------------------------|:-----------|:----------------|:--------|
-| Cursor CLI               | `agent`    | Direct download | Yes     |
+| Cursor CLI               | `agent`    | Direct download | No      |
 | Claude CLI (Claude Code) | `claude`   | Script          | Yes     |
-| Gemini CLI               | `gemini`   | npm             | Yes     |
+| Antigravity CLI          | `agy`      | Script          | Yes     |
+| Gemini CLI               | `gemini`   | npm             | No      |
 | OpenCode                 | `opencode` | npm             | No      |
 | Kilo CLI                 | `kilo`     | npm             | No      |
 | Amp (Sourcegraph)        | `amp`      | Script          | No      |
 | Codex CLI                | `codex`    | npm             | No      |
 | Copilot CLI              | `copilot`  | npm             | No      |
 
+Command aliases are also accepted: `agy` resolves to `antigravity`, and `agent`
+resolves to `cursor`.
+
 ## How Version Data Works
 
 code-aide uses a two-layer version data model:
@@ -86,29 +91,32 @@ Each entry in `tools.json` describes one managed tool. Required fields are
 `name`, `command`, and `install_type`; the others are optional and only
 consulted when the relevant install method or platform applies.
 
-| Field                         | Required | Notes                                                                                        |
-|:------------------------------|:---------|:---------------------------------------------------------------------------------------------|
-| `name`                        | Yes      | Display name for status output                                                               |
-| `command`                     | Yes      | Binary name (looked up in `PATH`)                                                            |
-| `install_type`                | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
-| `version_args`                | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
-| `version_url`                 | No       | URL queried by `update-versions` to discover the latest upstream version                     |
-| `latest_version`              | Cache    | Last known upstream version (filled by `update-versions`)                                    |
-| `latest_date`                 | Cache    | Release date for `latest_version`                                                            |
-| `prerequisites`               | No       | List of required external commands (e.g. `["npm"]`)                                          |
-| `min_node_version`            | No       | Minimum major Node.js version required                                                       |
-| `npm_package`                 | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
-| `install_url`                 | script   | URL of the install script that will be downloaded and piped to `bash`                        |
-| `install_sha256`              | script   | SHA-256 of the install script body — required for verified installs                          |
-| `install_script_path_prepend` | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
-| `download_url_template`       | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
-| `install_dir`                 | direct   | Directory to extract into; supports `{version}`                                              |
-| `bin_dir`                     | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
-| `symlinks`                    | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
-| `freebsd_port`                | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
-| `freebsd_pkg_repo`            | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
-| `next_steps`                  | No       | Free-form text printed after a successful install                                            |
-| `docs_url`                    | No       | Documentation URL printed after install                                                      |
+| Field                           | Required | Notes                                                                                        |
+|:--------------------------------|:---------|:---------------------------------------------------------------------------------------------|
+| `name`                          | Yes      | Display name for status output                                                               |
+| `command`                       | Yes      | Binary name (looked up in `PATH`)                                                            |
+| `aliases`                       | No       | Alternate names accepted by commands and resolved to the canonical tool key                  |
+| `install_type`                  | Yes      | One of `npm`, `script`, `direct_download`, `pkg`                                             |
+| `version_args`                  | No       | List of arguments passed to the binary to print its version (default: `["--version"]`)       |
+| `version_url`                   | No       | URL queried by `update-versions` to discover the latest upstream version                     |
+| `version_manifest_url_template` | No       | JSON manifest URL template with `{platform}`; reads its `version` field                      |
+| `latest_version`                | Cache    | Last known upstream version (filled by `update-versions`)                                    |
+| `latest_date`                   | Cache    | Release date for `latest_version`                                                            |
+| `prerequisites`                 | No       | List of required external commands (e.g. `["npm"]`)                                          |
+| `min_node_version`              | No       | Minimum major Node.js version required                                                       |
+| `npm_package`                   | npm      | npm package name (e.g. `@anthropic-ai/claude-code`)                                          |
+| `install_url`                   | script   | URL of the install script that will be downloaded and piped to `bash`                        |
+| `install_sha256`                | script   | SHA-256 of the install script body — required for verified installs                          |
+| `install_script_path_prepend`   | script   | Extra directories prepended to `PATH` when the install script runs (e.g. `["~/.local/bin"]`) |
+| `download_url_template`         | direct   | URL template with `{version}`, `{os}`, `{arch}` placeholders                                 |
+| `install_dir`                   | direct   | Directory to extract into; supports `{version}`                                              |
+| `bin_dir`                       | direct   | Directory where symlinks for `command` are created (e.g. `~/.local/bin`)                     |
+| `symlinks`                      | direct   | Map of `link_name` → relative path inside `install_dir` to symlink into `bin_dir`            |
+| `freebsd_port`                  | FreeBSD  | FreeBSD ports/pkg name (used when running on FreeBSD)                                        |
+| `freebsd_pkg_repo`              | FreeBSD  | Optional non-default pkg repository name (passed via `pkg install -r <repo>`)                |
+| `next_steps`                    | No       | Free-form text printed after a successful install                                            |
+| `docs_url`                      | No       | Documentation URL printed after install                                                      |
+| `self_updates`                  | No       | Tool updates itself when run; excludes it from managed upgrade actions                       |
 
 ## Features
 

{code_aide-1.15.7 → code_aide-1.16.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "code-aide"
 dynamic = ["version"]
-description = "Manage AI coding CLI tools (Claude, Copilot, Cursor, Gemini, Amp, Codex)"
+description = "Manage AI coding CLI tools (Claude, Antigravity, Copilot, Cursor, Gemini, Amp, Codex)"
 readme = "README.md"
 authors = [
     { name = "Dave Beckett" },

code_aide-1.16.1/script-archive/antigravity-install.sh

@@ -0,0 +1,239 @@
+#!/bin/bash
+#
+# Antigravity CLI - Unix Bootstrapper Script (Bash/Zsh/Fish)
+#
+# Downloads, staging-verifies, and installs the Antigravity CLI flat native build.
+#
+
+set -euo pipefail
+
+# 1. Default Setup & Constants
+DOWNLOAD_BASE_URL="https://antigravity-cli-auto-updater-974169037036.us-central1.run.app"
+TARGET_DIR="$HOME/.local/bin"
+CUSTOM_DIR=""
+
+# Helper: Display usage instructions
+show_usage() {
+    echo "Usage: install.sh [options]"
+    echo ""
+    echo "Options:"
+    echo "  -d, --dir <path>    Specify a custom directory to install the binary"
+    echo "  -h, --help          Display this help menu"
+    echo ""
+}
+
+# Parse Arguments
+while [ "$#" -gt 0 ]; do
+    case $1 in
+        -d|--dir)
+            if [ -z "${2:-}" ]; then
+                echo "[ERROR] Missing path for --dir parameter" >&2
+                exit 1
+            fi
+            CUSTOM_DIR="$2"
+            shift
+            ;;
+        -h|--help)
+            show_usage
+            exit 0
+            ;;
+        *)
+            echo "[ERROR] Unknown parameter: $1" >&2
+            show_usage
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+# Resolve dynamic installation target directory
+if [ -n "$CUSTOM_DIR" ]; then
+    TARGET_DIR="$CUSTOM_DIR"
+fi
+
+BINARY_PATH="$TARGET_DIR/agy"
+
+# 2. STEP 1: Pre-existence & Dynamic Path Check
+if [ -f "$BINARY_PATH" ]; then
+    echo "Notice: 'agy' is already installed at $BINARY_PATH."
+    echo "The Antigravity CLI automatically self-updates in the background during regular runs."
+    echo ""
+    echo "If you want to perform a fresh installation, delete the binary first:"
+    echo "  rm \"$BINARY_PATH\""
+    exit 0
+fi
+
+echo "⠋ Detecting system environment..."
+
+# 3. Detect Platform
+case "$(uname -s)" in
+    Darwin) os="darwin" ;;
+    Linux) os="linux" ;;
+    *) echo "Fatal: Unsupported operating system: $(uname -s). Antigravity CLI currently supports 64-bit Windows, macOS, and Linux." >&2; exit 1 ;;
+esac
+
+case "$(uname -m)" in
+    x86_64|amd64) arch="amd64" ;;
+    arm64|aarch64) arch="arm64" ;;
+    *) echo "Fatal: Unsupported architecture: $(uname -m). Antigravity CLI currently supports 64-bit Windows, macOS, and Linux." >&2; exit 1 ;;
+esac
+
+# musl libc detection on Linux
+platform=""
+if [ "$os" = "linux" ]; then
+    if [ -f /lib/libc.musl-x86_64.so.1 ] || [ -f /lib/libc.musl-aarch64.so.1 ] || ldd /bin/ls 2>&1 | grep -q musl; then
+        platform="linux_${arch}_musl"
+    else
+        platform="linux_${arch}"
+    fi
+else
+    platform="${os}_${arch}"
+fi
+
+echo "✓ Platform detected: $platform"
+
+# 4. Manifest Query & JSON Parsing (POSIX-Compliant)
+echo "⠋ Querying release repository..."
+
+# Construct Platform JSON Manifest URL
+MANIFEST_URL="$DOWNLOAD_BASE_URL/manifests/$platform.json"
+
+DOWNLOADER=""
+if command -v curl >/dev/null 2>&1; then
+    DOWNLOADER="curl"
+elif command -v wget >/dev/null 2>&1; then
+    DOWNLOADER="wget"
+else
+    echo "Fatal: Either curl or wget is required but neither is installed." >&2
+    exit 1
+fi
+
+fetch_manifest() {
+    if [ "$DOWNLOADER" = "curl" ]; then
+        curl -fsSL "$1"
+    else
+        wget -q -O - "$1"
+    fi
+}
+
+manifest_json=$(fetch_manifest "$MANIFEST_URL" 2>/dev/null || true)
+if [ -z "$manifest_json" ]; then
+    echo "Fatal: Could not connect to the release server to download the manifest. Please check your internet connection or firewall settings." >&2
+    exit 1
+fi
+
+# POSIX-compliant JSON parser (no jq or grep -o dependencies)
+parse_json_key() {
+    local payload="$1"
+    local key="$2"
+    echo "$payload" | sed -n 's/.*"'"$key"'"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p'
+}
+
+version=$(parse_json_key "$manifest_json" "version")
+url=$(parse_json_key "$manifest_json" "url")
+sha512=$(parse_json_key "$manifest_json" "sha512")
+
+if [ -z "$url" ] || [ -z "$sha512" ]; then
+    echo "Fatal: Failed to parse release manifest. The manifest may be corrupted or malformed." >&2
+    exit 1
+fi
+
+echo "✓ Latest available version: $version"
+
+# 5. Download & SHA512 Checksum Verification
+STAGING_DIR="$HOME/.cache/antigravity/staging"
+if ! mkdir -p "$STAGING_DIR" 2>/dev/null; then
+    echo "Error: Failed to create staging directory at $STAGING_DIR. Please check your home directory write permissions." >&2
+    exit 1
+fi
+
+is_tar_gz=false
+case "$url" in
+    *.tar.gz*) is_tar_gz=true ;;
+esac
+
+if [ "$is_tar_gz" = true ]; then
+    staging_payload="$STAGING_DIR/agy.tar.gz"
+    extracted_binary="$STAGING_DIR/antigravity"
+else
+    staging_payload="$STAGING_DIR/agy"
+    extracted_binary="$staging_payload"
+fi
+
+# Robust cleanup trap to ensure staging files are reaped on any exit (success or failure)
+cleanup() {
+    rm -f "${staging_payload:-}" "${extracted_binary:-}" 2>/dev/null || true
+}
+trap cleanup EXIT
+
+download_file() {
+    local src="$1"
+    local dst="$2"
+    if [ "$DOWNLOADER" = "curl" ]; then
+        curl -fsSL -o "$dst" "$src"
+    else
+        wget -q -O "$dst" "$src"
+    fi
+}
+
+echo "⠋ Downloading release package..."
+if ! download_file "$url" "$staging_payload"; then
+    echo "Fatal: Failed to download release package from $url. Please check your internet connection or firewall settings." >&2
+    exit 1
+fi
+
+# Compute OS-Specific SHA512 Checksum
+actual_hash=""
+if [ "$os" = "darwin" ]; then
+    actual_hash=$(shasum -a 512 "$staging_payload" | cut -d' ' -f1 || true)
+else
+    actual_hash=$(sha512sum "$staging_payload" | cut -d' ' -f1 || true)
+fi
+
+if [ "$actual_hash" != "$sha512" ]; then
+    echo "Security Halt: The downloaded payload checksum does not match the manifest. The file may be corrupted or compromised. Installation aborted." >&2
+    exit 1
+fi
+echo "✓ Download complete and checksum verified."
+
+# 6. Direct Binary Extraction & Write Permission Validation
+if ! mkdir -p "$TARGET_DIR" 2>/dev/null; then
+    echo "Write Error: Permission denied when attempting to create $TARGET_DIR. Please re-run the installer using the '--dir' flag to specify a writable custom directory." >&2
+    exit 1
+fi
+
+if [ "$is_tar_gz" = true ]; then
+    echo "⠋ Extracting binary from archive..."
+    if ! tar -xzf "$staging_payload" -C "$STAGING_DIR" antigravity 2>/dev/null; then
+        echo "Extraction Error: Failed to extract binary from archive." >&2
+        exit 1
+    fi
+else
+    echo "⠋ Copying binary directly to destination..."
+fi
+
+if ! cp "$extracted_binary" "$BINARY_PATH" 2>/dev/null; then
+    echo "Write Error: Permission denied when attempting to write binary to $BINARY_PATH. Please re-run the installer using the '--dir' flag to specify a writable custom directory." >&2
+    exit 1
+fi
+
+# Ensure Executable Permission Bit (soft fallback if filesystem doesn't support chmod)
+chmod +x "$BINARY_PATH" || echo "Warning: Could not set executable permission bit on $BINARY_PATH. You may need to ensure the partition supports execution." >&2
+
+# Clear macOS Gatekeeper Quarantine attribute to prevent unidentified developer blocks
+if [ "$os" = "darwin" ]; then
+    xattr -d com.apple.quarantine "$BINARY_PATH" 2>/dev/null || true
+fi
+
+# 7. Native Setup Handoff (Go-Native Setup Trigger - POSIX /bin/sh Compliant)
+echo "⠋ Configuring shell environment..."
+
+if [ -n "$CUSTOM_DIR" ]; then
+    # Run with custom directory and absorb non-fatal soft warning exits
+    "$BINARY_PATH" install --dir "$CUSTOM_DIR" || true
+else
+    # Run standard configuration and absorb non-fatal soft warning exits
+    "$BINARY_PATH" install || true
+fi
+
+

{code_aide-1.15.7 → code_aide-1.16.1}/script-archive/claude-install.sh

@@ -11,6 +11,30 @@ if [[ -n "$TARGET" ]] && [[ ! "$TARGET" =~ ^(stable|latest|[0-9]+\.[0-9]+\.[0-9]
     exit 1
 fi
 
+# Refuse to run under sudo from a regular user's shell. This installer puts
+# everything under $HOME, which under sudo typically resolves to root's home:
+# the binary lands in /root/.local/bin (or is left root-owned in the user's
+# home, depending on the distro's sudo configuration), and the 'claude'
+# command is then not found in the user's own shell. Plain root with no sudo
+# (containers, CI, root-only systems) is unaffected by this check.
+if [ "$(id -u)" -eq 0 ] && [ -n "${SUDO_USER:-}" ] && [ "$SUDO_USER" != "root" ] && [ -z "${CLAUDE_INSTALL_ALLOW_SUDO:-}" ]; then
+    echo "Error: do not run this installer with sudo." >&2
+    echo "" >&2
+    echo "Claude Code installs into your home directory and does not need root access." >&2
+    echo "With sudo, the installation would go into root's home directory instead of" >&2
+    echo "yours, and the 'claude' command would not work from your own shell." >&2
+    echo "" >&2
+    echo "Please re-run the same command without sudo, e.g.:" >&2
+    # pinned-dep-allow: display-only guidance text in an error message, not an executed install; install.sh is Anthropic's own installer
+    echo "    curl -fsSL https://claude.ai/install.sh | bash" >&2
+    echo "" >&2
+    echo "To intentionally install Claude Code for the root user, re-run with" >&2
+    echo "CLAUDE_INSTALL_ALLOW_SUDO=1 set in the installer's environment, e.g.:" >&2
+    # pinned-dep-allow: display-only guidance text in an error message, not an executed install; install.sh is Anthropic's own installer
+    echo "    curl -fsSL https://claude.ai/install.sh | sudo CLAUDE_INSTALL_ALLOW_SUDO=1 bash" >&2
+    exit 1
+fi
+
 DOWNLOAD_BASE_URL="https://downloads.claude.ai/claude-code-releases"
 DOWNLOAD_DIR="$HOME/.claude/downloads"
 

code_aide-1.16.1/specs/antigravity-cli-integration.md

@@ -0,0 +1,35 @@
+# Add Antigravity CLI support
+
+## Context
+
+Google transitioned consumer Gemini CLI access to Antigravity CLI on June 18,
+2026. Gemini CLI remains valid for enterprise, Google Cloud, and supported API
+key authentication, so code-aide must manage the two commands separately and
+must not remove or migrate existing Gemini installations.
+
+## Design
+
+- Add Antigravity as the default tool key `antigravity`, using command `agy`.
+- Accept `agy` as a command-line alias for the canonical `antigravity` key.
+- Install it through Google's native script and verify the archived script's
+  SHA-256 before execution.
+- Query the installer's official platform manifest and read its `version` field
+  when refreshing the latest-version cache.
+- Record that `agy` uses its native background self-updater, so code-aide does
+  not repeatedly invoke an installer that intentionally exits when the binary
+  already exists.
+- Keep Gemini CLI available as an opt-in npm tool with updated authentication
+  guidance.
+- Do not infer a user's Google subscription or automatically migrate Gemini.
+
+The manifest URL uses `{platform}` values such as `darwin_arm64` and
+`linux_amd64`. The formatter supports the macOS and Linux architectures that the
+upstream Unix installer supports.
+
+## Verification
+
+1. Confirm the archived installer exactly matches the configured SHA-256.
+2. Test manifest URL formatting and JSON version extraction.
+3. Run `uv run pytest` and `pre-commit run --all-files`.
+4. Dry-run `code-aide update-versions` and confirm Antigravity reports the
+   manifest version.

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/__init__.py

@@ -1,3 +1,3 @@
 """code-aide - Manage AI coding CLI tools."""
 
-__version__ = "1.15.7"
+__version__ = "1.16.1"

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/commands_actions.py

@@ -37,6 +37,7 @@ from code_aide.config import (
     load_bundled_tools,
     load_versions_cache,
     merge_cached_versions,
+    resolve_tool_names,
     save_updated_versions,
 )
 
@@ -65,6 +66,7 @@ def cmd_install(args: argparse.Namespace) -> None:
                 f"{', '.join(tools_to_install)}"
             )
 
+    tools_to_install = resolve_tool_names(tools_to_install, TOOLS)
     validate_tools(tools_to_install)
 
     if not dryrun:
@@ -144,6 +146,7 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
             info("All installed tools are up to date")
             return
 
+    tools_to_upgrade = resolve_tool_names(tools_to_upgrade, TOOLS)
     validate_tools(tools_to_upgrade)
 
     updated = []
@@ -204,6 +207,7 @@ def cmd_remove(args: argparse.Namespace) -> None:
         tools_to_remove = list(TOOLS.keys())
         info(f"No tools specified, removing all: {', '.join(tools_to_remove)}")
 
+    tools_to_remove = resolve_tool_names(tools_to_remove, TOOLS)
     validate_tools(tools_to_remove)
 
     removed = []
@@ -253,12 +257,12 @@ def cmd_update_versions(args: argparse.Namespace) -> None:
     config: Dict[str, Any] = {"tools": tools}
 
     if args.tools:
-        invalid = [tool for tool in args.tools if tool not in tools]
+        tool_names = resolve_tool_names(args.tools, tools)
+        invalid = [tool for tool in tool_names if tool not in tools]
         if invalid:
             error(f"Unknown tool(s): {', '.join(invalid)}")
             print(f"Available: {', '.join(tools.keys())}", file=sys.stderr)
             sys.exit(1)
-        tool_names = args.tools
     else:
         tool_names = list(tools.keys())
 

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/config.py

@@ -118,6 +118,23 @@ def load_tools_config() -> dict:
     return tools
 
 
+def resolve_tool_names(
+    names: list[str], tools: Mapping[str, Dict[str, Any]]
+) -> list[str]:
+    """Resolve configured aliases to canonical tool names, preserving order."""
+    aliases = {
+        alias: tool_name
+        for tool_name, tool_config in tools.items()
+        for alias in tool_config.get("aliases", [])
+    }
+    resolved = []
+    for name in names:
+        canonical = aliases.get(name, name)
+        if canonical not in resolved:
+            resolved.append(canonical)
+    return resolved
+
+
 def save_updated_versions(tools: Mapping[str, Dict[str, Any]]) -> None:
     """Save only dynamic version fields to the user's cache.
 
@@ -158,7 +175,10 @@ def versions_cache_is_fresh(tools: Mapping[str, Dict[str, Any]]) -> bool:
             if not tool_config.get("latest_version"):
                 return False
         elif install_type in (InstallType.SCRIPT, InstallType.DIRECT_DOWNLOAD):
-            if tool_config.get("version_url") and not tool_config.get("latest_version"):
+            has_version_source = tool_config.get("version_url") or tool_config.get(
+                "version_manifest_url_template"
+            )
+            if has_version_source and not tool_config.get("latest_version"):
                 return False
     return True
 

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/data/tools.json

@@ -4,6 +4,9 @@
     "cursor": {
       "name": "Cursor CLI",
       "command": "agent",
+      "aliases": [
+        "agent"
+      ],
       "install_type": "direct_download",
       "install_url": "https://cursor.com/install",
       "install_script_note": "Legacy install script archived but no longer used; switched to direct_download which extracts the binary directly without a shell script",
@@ -21,14 +24,14 @@
         "--version"
       ],
       "docs_url": "https://docs.cursor.com/",
-      "default_install": true
+      "default_install": false
     },
     "claude": {
       "name": "Claude CLI (Claude Code)",
       "command": "claude",
       "install_type": "script",
       "install_url": "https://claude.ai/install.sh",
-      "install_sha256": "b3f79015b54c751440a6488f07b1b64f9088742b9052bc1bd356d13108320d2a",
+      "install_sha256": "cde4f1702d3b1695f92b73d26888364e17bca476e17f0fd676484c951d36c125",
       "version_url": "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest",
       "prerequisites": [],
       "min_node_version": null,
@@ -50,15 +53,35 @@
         "npm"
       ],
       "min_node_version": 20,
-      "next_steps": "Run 'gemini' and choose 'Login with Google' to authenticate",
+      "next_steps": "Run 'gemini' and authenticate with a supported enterprise, Google Cloud, or API-key account",
       "version_args": [
         "--version"
       ],
       "docs_url": "https://github.com/google-gemini/gemini-cli",
-      "default_install": true,
+      "default_install": false,
       "freebsd_port": "gemini-cli",
       "freebsd_pkg_repo": "FreeBSD-latest"
     },
+    "antigravity": {
+      "name": "Antigravity CLI",
+      "command": "agy",
+      "aliases": [
+        "agy"
+      ],
+      "install_type": "script",
+      "install_url": "https://antigravity.google/cli/install.sh",
+      "install_sha256": "ee1ea43ce4e9e56356c4ab6dad907ef357ae4bdfcaadb682735909fb57c9c640",
+      "version_manifest_url_template": "https://antigravity-cli-auto-updater-974169037036.us-central1.run.app/manifests/{platform}.json",
+      "prerequisites": [],
+      "min_node_version": null,
+      "next_steps": "Run 'agy' to authenticate and start",
+      "version_args": [
+        "--version"
+      ],
+      "docs_url": "https://antigravity.google/docs/cli-overview",
+      "self_updates": true,
+      "default_install": true
+    },
     "amp": {
       "name": "Amp (Sourcegraph)",
       "command": "amp",

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/operations.py

@@ -187,6 +187,13 @@ def upgrade_tool(tool_name: str) -> UpgradeResult:
     if is_deprecated_install(tool_name):
         return _migrate_install_method(tool_name)
 
+    if tool_config.get("self_updates"):
+        info(
+            f"{tool_config['name']} updates itself in the background when it runs; "
+            f"launch '{tool_config['command']}' to allow it to update."
+        )
+        return UpgradeResult.UNCHANGED
+
     install_info = detect_install_method(tool_name)
     method = parse_install_method(install_info["method"])
     detail = install_info["detail"]

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/status.py

@@ -58,6 +58,7 @@ class UpgradeDecision(Enum):
     UPGRADE = auto()
     MIGRATION = auto()
     PACKAGE_MANAGED = auto()
+    SELF_UPDATING = auto()
     NOT_INSTALLED = auto()
     UNKNOWN = auto()
 
@@ -183,6 +184,20 @@ class ToolUpgradeEvaluator:
         package_info: Optional[PackageInfo],
     ) -> ToolUpgradeAssessment:
         version_state = self._catalog_version_state(status.get("version"))
+        if self.tool_config.get("self_updates"):
+            decision = (
+                UpgradeDecision.CURRENT
+                if version_state == VersionDisplayState.UP_TO_DATE
+                else UpgradeDecision.SELF_UPDATING
+            )
+            return self._result(
+                decision=decision,
+                version_state=version_state,
+                status=status,
+                install_info=install_info,
+                package_info=package_info,
+            )
+
         if version_state == VersionDisplayState.UP_TO_DATE:
             decision = UpgradeDecision.CURRENT
         elif version_state == VersionDisplayState.OUTDATED:

{code_aide-1.15.7 → code_aide-1.16.1}/src/code_aide/versions.py

@@ -3,6 +3,7 @@
 import email.utils
 import hashlib
 import json
+import platform
 import re
 import urllib.request
 from datetime import datetime, timezone
@@ -116,6 +117,25 @@ def version_is_newer(version_a: str, version_b: str) -> bool:
     return a_parts > b_parts
 
 
+def format_version_manifest_url(url_template: str) -> str:
+    """Fill a manifest URL template with the current OS and architecture."""
+    os_name = platform.system().lower()
+    if os_name not in ("darwin", "linux"):
+        raise ValueError(f"Unsupported manifest operating system: {os_name}")
+
+    machine = platform.machine().lower()
+    architecture = {
+        "x86_64": "amd64",
+        "amd64": "amd64",
+        "arm64": "arm64",
+        "aarch64": "arm64",
+    }.get(machine)
+    if architecture is None:
+        raise ValueError(f"Unsupported manifest architecture: {machine}")
+
+    return url_template.format(platform=f"{os_name}_{architecture}")
+
+
 def check_npm_tool(
     tool_name: str, tool_config: Dict[str, Any], verbose: bool = False
 ) -> Dict[str, Any]:
@@ -176,6 +196,26 @@ def extract_script_version(
     script_content: bytes,
 ) -> Optional[str]:
     """Try to extract a version string from script content or version URL."""
+    version_manifest_url_template = tool_config.get("version_manifest_url_template")
+    if version_manifest_url_template:
+        try:
+            version_manifest_url = format_version_manifest_url(
+                version_manifest_url_template
+            )
+            manifest_data, _ = fetch_url(version_manifest_url)
+            manifest = json.loads(manifest_data)
+            version = manifest.get("version")
+            if isinstance(version, str) and version.strip():
+                return version.strip()
+        except (
+            OSError,
+            UnicodeDecodeError,
+            json.JSONDecodeError,
+            TypeError,
+            ValueError,
+        ):
+            pass
+
     version_url = tool_config.get("version_url")
     if version_url:
         try:

{code_aide-1.15.7 → code_aide-1.16.1}/tests/test_commands_actions.py

@@ -83,6 +83,36 @@ class TestCmdInstall(unittest.TestCase):
 
         mock_check_path.assert_called_once_with(["/home/test/.npm-packages/bin"])
 
+    def test_resolves_tool_alias_before_installing(self):
+        tools = {
+            "antigravity": {
+                "name": "Antigravity CLI",
+                "command": "agy",
+                "aliases": ["agy"],
+                "install_type": "script",
+                "next_steps": "run agy",
+            }
+        }
+        args = type(
+            "Args",
+            (),
+            {"tools": ["agy"], "dryrun": False, "install_prerequisites": False},
+        )()
+
+        with (
+            mock.patch.dict(constants._TOOLS_DATA, tools, clear=True),
+            mock.patch.object(commands_actions, "check_prerequisites"),
+            mock.patch.object(
+                commands_actions,
+                "install_tool",
+                return_value=InstallOutcome(True),
+            ) as mock_install,
+            mock.patch.object(commands_actions, "check_path_directories"),
+        ):
+            commands_actions.cmd_install(args)
+
+        mock_install.assert_called_once_with("antigravity", dryrun=False)
+
 
 class TestCmdUpdateVersions(unittest.TestCase):
     """Tests for cmd_update_versions."""

{code_aide-1.15.7 → code_aide-1.16.1}/tests/test_config.py

@@ -38,6 +38,7 @@ class TestLoadBundledTools(unittest.TestCase):
         self.assertIn("claude", tools)
         self.assertIn("copilot", tools)
         self.assertIn("gemini", tools)
+        self.assertIn("antigravity", tools)
         self.assertIn("opencode", tools)
         self.assertIn("kilo", tools)
         for tool_name, tool_data in tools.items():
@@ -46,6 +47,68 @@ class TestLoadBundledTools(unittest.TestCase):
             self.assertIn("install_type", tool_data)
 
 
+class TestAntigravityConfig(unittest.TestCase):
+    """Antigravity remains separate from the supported Gemini CLI entry."""
+
+    def test_antigravity_uses_verified_script_and_manifest(self):
+        tools = code_aide_config.load_bundled_tools()["tools"]
+        antigravity = tools["antigravity"]
+
+        self.assertEqual(antigravity["command"], "agy")
+        self.assertIn("agy", antigravity["aliases"])
+        self.assertEqual(antigravity["install_type"], "script")
+        self.assertIn("install_sha256", antigravity)
+        self.assertIn("version_manifest_url_template", antigravity)
+        self.assertTrue(antigravity["self_updates"])
+        self.assertTrue(antigravity["default_install"])
+
+    def test_gemini_remains_available_but_is_not_default(self):
+        gemini = code_aide_config.load_bundled_tools()["tools"]["gemini"]
+
+        self.assertEqual(gemini["command"], "gemini")
+        self.assertFalse(gemini["default_install"])
+
+    def test_cursor_remains_available_but_is_not_default(self):
+        cursor = code_aide_config.load_bundled_tools()["tools"]["cursor"]
+
+        self.assertEqual(cursor["command"], "agent")
+        self.assertFalse(cursor["default_install"])
+
+
+class TestResolveToolNames(unittest.TestCase):
+    """Tool aliases resolve without creating duplicate catalog entries."""
+
+    def test_resolves_alias_to_canonical_name(self):
+        tools = {
+            "antigravity": {"aliases": ["agy"]},
+            "gemini": {},
+        }
+        self.assertEqual(
+            code_aide_config.resolve_tool_names(["agy"], tools),
+            ["antigravity"],
+        )
+
+    def test_resolves_command_name_alias(self):
+        tools = {"cursor": {"aliases": ["agent"]}}
+        self.assertEqual(
+            code_aide_config.resolve_tool_names(["agent"], tools),
+            ["cursor"],
+        )
+
+    def test_deduplicates_alias_and_canonical_name(self):
+        tools = {"antigravity": {"aliases": ["agy"]}}
+        self.assertEqual(
+            code_aide_config.resolve_tool_names(["agy", "antigravity"], tools),
+            ["antigravity"],
+        )
+
+    def test_preserves_unknown_name_for_validation(self):
+        self.assertEqual(
+            code_aide_config.resolve_tool_names(["missing"], {}),
+            ["missing"],
+        )
+
+
 class TestVersionsCacheRoundTrip(unittest.TestCase):
     """Tests for config save/load versions cache."""
 

{code_aide-1.15.7 → code_aide-1.16.1}/tests/test_operations.py

@@ -197,6 +197,27 @@ class TestMigrateInstallMethod(unittest.TestCase):
         self.assertEqual(result, UpgradeResult.CHANGED)
         mock_script.assert_called_once()
 
+    def test_upgrade_self_updating_tool_does_not_rerun_installer(self):
+        tool_config = {
+            "name": "Self-updating Tool",
+            "command": "self-tool",
+            "install_type": "script",
+            "install_url": "https://example.com/install.sh",
+            "self_updates": True,
+        }
+        with (
+            mock.patch.dict(constants._TOOLS_DATA, {"test": tool_config}),
+            mock.patch.object(cli_operations, "is_tool_installed", return_value=True),
+            mock.patch.object(
+                cli_operations, "is_deprecated_install", return_value=False
+            ),
+            mock.patch.object(cli_handlers, "run_install_script") as mock_script,
+        ):
+            result = cli_operations.upgrade_tool("test")
+
+        self.assertEqual(result, UpgradeResult.UNCHANGED)
+        mock_script.assert_not_called()
+
     def test_upgrade_script_detection_uses_tarball_when_config_direct_download(self):
         """Mis-detected script install still upgrades via tarball for cursor-like tools."""
         tool_config = {

{code_aide-1.15.7 → code_aide-1.16.1}/tests/test_status.py

@@ -193,6 +193,24 @@ class TestToolUpgradeEvaluator(unittest.TestCase):
         )
         self.assertTrue(assessment.actionable_by_upgrade)
 
+    def test_outdated_self_updating_tool_is_not_actionable(self):
+        assessment = self._evaluate(
+            {
+                "name": "Self-updating Tool",
+                "command": "self-tool",
+                "install_type": "script",
+                "latest_version": "2.0.0",
+                "self_updates": True,
+            },
+            status={"installed": True, "version": "1.0.0", "errors": []},
+            install_info={"method": "script", "detail": None},
+        )
+        self.assertEqual(assessment.decision, cli_status.UpgradeDecision.SELF_UPDATING)
+        self.assertEqual(
+            assessment.version_state, cli_status.VersionDisplayState.OUTDATED
+        )
+        self.assertFalse(assessment.actionable_by_upgrade)
+
     def test_brew_outdated_is_upgrade(self):
         assessment = self._evaluate(
             {

{code_aide-1.15.7 → code_aide-1.16.1}/tests/test_versions.py

@@ -1,6 +1,7 @@
 """Unit tests for CLI versioning and update-check helpers."""
 
 import unittest
+from unittest import mock
 
 from code_aide import versions as cli_versions
 
@@ -181,6 +182,33 @@ class TestVersionIsNewer(unittest.TestCase):
         )
 
 
+class TestFormatVersionManifestUrl(unittest.TestCase):
+    """Tests for platform-specific release manifest URLs."""
+
+    @mock.patch.object(cli_versions.platform, "machine", return_value="arm64")
+    @mock.patch.object(cli_versions.platform, "system", return_value="Darwin")
+    def test_formats_macos_arm64(self, _system, _machine):
+        result = cli_versions.format_version_manifest_url(
+            "https://example.com/manifests/{platform}.json"
+        )
+        self.assertEqual(result, "https://example.com/manifests/darwin_arm64.json")
+
+    @mock.patch.object(cli_versions.platform, "machine", return_value="x86_64")
+    @mock.patch.object(cli_versions.platform, "system", return_value="Linux")
+    def test_formats_linux_amd64(self, _system, _machine):
+        result = cli_versions.format_version_manifest_url(
+            "https://example.com/manifests/{platform}.json"
+        )
+        self.assertEqual(result, "https://example.com/manifests/linux_amd64.json")
+
+    @mock.patch.object(cli_versions.platform, "system", return_value="Windows")
+    def test_rejects_unsupported_os(self, _system):
+        with self.assertRaises(ValueError):
+            cli_versions.format_version_manifest_url(
+                "https://example.com/manifests/{platform}.json"
+            )
+
+
 class TestParseHttpDate(unittest.TestCase):
     """Tests for parse_http_date."""
 
@@ -323,3 +351,44 @@ class TestExtractScriptVersion(unittest.TestCase):
             cli_versions.extract_script_version("amp", {}, b'VERSION="2.0.1"\n'),
             "2.0.1",
         )
+
+    @mock.patch.object(
+        cli_versions,
+        "format_version_manifest_url",
+        return_value="https://example.com/manifests/darwin_arm64.json",
+    )
+    @mock.patch.object(cli_versions, "fetch_url")
+    def test_reads_version_from_json_manifest(self, mock_fetch, mock_format):
+        mock_fetch.return_value = (b'{"version": "1.1.1"}', None)
+
+        result = cli_versions.extract_script_version(
+            "antigravity",
+            {
+                "version_manifest_url_template": (
+                    "https://example.com/manifests/{platform}.json"
+                )
+            },
+            b"#!/bin/bash\n",
+        )
+
+        self.assertEqual(result, "1.1.1")
+        mock_format.assert_called_once()
+        mock_fetch.assert_called_once_with(
+            "https://example.com/manifests/darwin_arm64.json"
+        )
+
+    @mock.patch.object(cli_versions, "fetch_url")
+    def test_invalid_manifest_falls_back_to_script(self, mock_fetch):
+        mock_fetch.return_value = (b"not json", None)
+
+        result = cli_versions.extract_script_version(
+            "antigravity",
+            {
+                "version_manifest_url_template": (
+                    "https://example.com/manifests/{platform}.json"
+                )
+            },
+            b'VERSION="1.0.0"\n',
+        )
+
+        self.assertEqual(result, "1.0.0")