feat: add installation scripts, Makefile, and config template

.antigravity.md

@@ -0,0 +1,23 @@
+# Project Configuration for Antigravity CLI
+# Place this file in the root of your project to provide context to the AI agent.
+# Docs: https://antigravity.google/docs/cli-overview
+
+# Project Overview
+# Describe your project, its purpose, and key technologies.
+# Example:
+#
+# This is a Python FastAPI backend with PostgreSQL.
+# - Use Pydantic v2 (model_dump(), not dict())
+# - All endpoints must have OpenAPI descriptions
+# - Tests: pytest with async fixtures
+# - Docker: compose v2 format
+
+# Coding Standards
+# - Follow PEP8 / ESLint / your linter rules
+# - Use meaningful commit messages (conventional commits)
+# - All functions must have docstrings/JSDoc
+
+# Security
+# - Never hardcode credentials — use environment variables
+# - Validate all user input
+# - Use parameterized queries for SQL

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 The terminal-first surface to interact with Antigravity agents. Stay in your flow without context switching.
 
+## 1.0.2
+
+- Added `AGY_CLI_HIDE_ACCOUNT_INFO` environment variable to hide email and plan tier from the header.
+- Fixed timeout overrides: restricted the default 60-second interaction timeout specifically to subagents, preventing the main agent from being unconditionally capped.
+- Fixed a nil-pointer panic in Sandbox Mode: resolved a typed nil interface comparison when fetching URL content.
+- Fixed fallback skill discovery in Standalone mode: ensures custom/fallback skills are successfully loaded even if the standard configuration directory is missing, and added automatic path deduplication to prevent duplicates.
+- Fixed command rendering in message history: prefixed slash commands with a caret (`>`) in response block headers to clearly distinguish user-typed commands from agent outputs.
+- Fixed plugin installation path mismatch: updated the `plugin` subcommand to install downloaded plugins directly to the shared configuration directory (`~/.gemini/config/`) rather than the private application data folder, making them instantly discoverable.
+- Fixed Git short-hash support in diff selection: updated the commit hash recognition pattern in the  /diff  commit selection tree to match Git's standard 7-character short hashes (and up to 40-character full hashes).
+- Fixed statusline subcommand handling and recursive loops: added case-insensitive subcommand parsing (help, delete, reset, enable/on, disable/off) to the /statusline command, providing direct control to toggle or revert custom statuslines and blocking recursive shell hangs during help queries.
+- Improved `/help` shortcuts tab by sorting shortcuts by keybinding key, adding missing keybindings (like `ctrl+r`, `ctrl+o`, `alt+j`, `ctrl+k`), and generalizing scrolling (PageUp/PageDown/GoToTop/GoToBottom) for both Commands and Shortcuts tabs.
+
 ## 1.0.1
 
 - Fixed OAuth token persistence and authentication hangs.
@@ -14,7 +26,7 @@ The terminal-first surface to interact with Antigravity agents. Stay in your flo
 - Moves the **terminal** color scheme to the top of the selection list, making it the default choice during onboarding and in `/settings`.
 - Improved `/usage` and `/quota` commands. Forces a real-time reload of model configuration and remaining quotas, allowing you to see updated real-time consumption statistics immediately.
 - Improved step rendering layout. Calculates available terminal width dynamically and uses middle-truncation (`/foo/.../bar`) for file path tools to prevent layout shifting on narrow screens.
-- Improved session deletion keybinding in `/reusme`. Changed the shortcut from `ctrl+d` to `ctrl+delete` to resolve conflicts with the global exit keybinding (`ctrl+d` `ctrl+d`) and preserve Emacs-style forward-delete in search input fields.
+- Improved session deletion keybinding in `/resume`. Changed the shortcut from `ctrl+d` to `ctrl+delete` to resolve conflicts with the global exit keybinding (`ctrl+d` `ctrl+d`) and preserve Emacs-style forward-delete in search input fields.
 - Restored automatic table wrapping, preventing long cells inside markdown tables from being truncated.
 - Resolved an issue where deleted files (represented by `+++ /dev/null`) had their deletion lines incorrectly merged into the previous file's diff.
 

Makefile

@@ -0,0 +1,66 @@
+.PHONY: install update uninstall check help
+
+BINARY_NAME := agy
+INSTALL_DIR := $(HOME)/.local/bin
+BINARY_PATH := $(INSTALL_DIR)/$(BINARY_NAME)
+
+help: ## Show this help
+	@echo "Antigravity CLI — Makefile targets:"
+	@echo ""
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2}'
+	@echo ""
+
+install: ## Install Antigravity CLI via official script
+	@if [ -f "$(BINARY_PATH)" ]; then \
+		echo "✓ agy is already installed at $(BINARY_PATH)"; \
+		echo "  Run 'make update' to update, or 'make reinstall' for fresh install."; \
+	else \
+		echo "⠋ Installing Antigravity CLI..."; \
+		bash install.sh; \
+		echo ""; \
+		echo "✓ Installation complete! Run 'agy' to start."; \
+	fi
+
+reinstall: uninstall install ## Remove and reinstall
+
+update: ## Update to the latest version
+	@if [ -f "$(BINARY_PATH)" ]; then \
+		echo "⠋ Updating Antigravity CLI..."; \
+		$(BINARY_PATH) update; \
+	else \
+		echo "✗ agy is not installed. Run 'make install' first."; \
+		exit 1; \
+	fi
+
+uninstall: ## Remove Antigravity CLI binary
+	@if [ -f "$(BINARY_PATH)" ]; then \
+		rm -f "$(BINARY_PATH)"; \
+		echo "✓ Removed $(BINARY_PATH)"; \
+	else \
+		echo "✓ agy is not installed at $(BINARY_PATH)"; \
+	fi
+
+check: ## Check if agy is installed and show version
+	@if command -v agy >/dev/null 2>&1; then \
+		echo "✓ agy found: $$(command -v agy)"; \
+		echo "  Version: $$(agy --version 2>/dev/null || echo 'unknown')"; \
+	elif [ -f "$(BINARY_PATH)" ]; then \
+		echo "✓ agy found at $(BINARY_PATH) (not in PATH)"; \
+		echo "  Version: $$($(BINARY_PATH) --version 2>/dev/null || echo 'unknown')"; \
+		echo ""; \
+		echo "  Add to PATH:"; \
+		echo "    export PATH=\"$(INSTALL_DIR):\$$PATH\""; \
+	else \
+		echo "✗ agy is not installed. Run 'make install'."; \
+		exit 1; \
+	fi
+
+run: ## Start agy interactive session
+	@if command -v agy >/dev/null 2>&1; then \
+		agy; \
+	elif [ -f "$(BINARY_PATH)" ]; then \
+		$(BINARY_PATH); \
+	else \
+		echo "✗ agy is not installed. Run 'make install' first."; \
+		exit 1; \
+	fi

install.cmd

@@ -0,0 +1,241 @@
+@echo off
+setlocal enabledelayedexpansion
+:: Absolute early argument sanitization to prevent RCE/LCE metacharacter injections safely
+set "CMD_LINE=!CMDCMDLINE!"
+echo(!CMD_LINE! | findstr /c:"&" /c:"|" /c:";" /c:"<" /c:">" /c:"^" >nul 2>&1
+if !ERRORLEVEL! equ 0 (
+    echo Fatal: Illegal shell characters detected in command line arguments. >&2
+    exit /b 1
+)
+endlocal
+setlocal disabledelayedexpansion
+
+set "DOWNLOAD_BASE_URL=https://antigravity-cli-auto-updater-974169037036.us-central1.run.app"
+set "CUSTOM_DIR="
+set "FORWARD_ARGS="
+
+:parse_args
+if "%~1" == "" goto :args_done
+if "%~1" == "-d" goto :handle_d
+if "%~1" == "--dir" goto :handle_d
+:: Accumulate other arguments to forward. Delayed expansion is disabled here,
+:: so we must use standard percent-style expansion.
+set "FORWARD_ARGS=%FORWARD_ARGS% %1"
+shift
+goto :parse_args
+
+:handle_d
+if "%~2" == "" (
+    echo Error: Missing value for %~1 option. >&2
+    exit /b 1
+)
+set "CUSTOM_DIR=%~2"
+shift & shift
+goto :parse_args
+
+:args_done
+setlocal enabledelayedexpansion
+:: Use standard LOCALAPPDATA variable
+set "TARGET_DIR=!LOCALAPPDATA!\agy\bin"
+if not "!CUSTOM_DIR!" == "" set "TARGET_DIR=!CUSTOM_DIR!"
+set "BINARY_PATH=!TARGET_DIR!\agy.exe"
+
+REM Pre-existence & Dynamic Path Check
+if exist "!BINARY_PATH!" (
+    echo Notice: 'agy.exe' is already installed at !BINARY_PATH!.
+    echo The Antigravity CLI automatically self-updates in the background.
+    echo If you want to perform a fresh installation, delete the binary first:
+    echo   del "!BINARY_PATH!"
+    exit /b 0
+)
+
+REM 1. Detect Architecture
+if /i "%PROCESSOR_ARCHITECTURE%"=="AMD64" (
+    set "PLATFORM=windows_amd64"
+) else if /i "%PROCESSOR_ARCHITECTURE%"=="ARM64" (
+    set "PLATFORM=windows_arm64"
+) else (
+    echo Fatal: Unsupported CPU architecture. >&2
+    exit /b 1
+)
+
+REM 2. Query Manifest & Parse securely via pure-CMD
+set "LOCAL_MODE=false"
+set "SCRIPT_DIR=%~dp0"
+set "LOCAL_MANIFEST=!SCRIPT_DIR!packages\manifests\!PLATFORM!.json"
+
+if exist "!LOCAL_MANIFEST!" (
+    set "MANIFEST_PATH=!LOCAL_MANIFEST!"
+    set "LOCAL_MODE=true"
+) else (
+    set "MANIFEST_URL=!DOWNLOAD_BASE_URL!/manifests/!PLATFORM!.json"
+    set "MANIFEST_PATH=!TEMP!\manifest_!RANDOM!.json"
+    curl -fsSL "!MANIFEST_URL!" -o "!MANIFEST_PATH!"
+    if !ERRORLEVEL! neq 0 (
+        echo Fatal: Failed to download release manifest from !MANIFEST_URL!. >&2
+        echo Please check your internet connection or firewall settings. >&2
+        if exist "!MANIFEST_PATH!" del "!MANIFEST_PATH!"
+        exit /b 1
+    )
+)
+
+:: Securely extract manifest values line-by-line (immune to minified JSON and spaces)
+set "VER_FILE=!TEMP!\ver_!RANDOM!.txt"
+findstr /c:"\"version\":" "!MANIFEST_PATH!" > "!VER_FILE!" 2>nul
+set "RAW_LINE="
+set /p RAW_LINE=<"!VER_FILE!" & del "!VER_FILE!"
+set "VERSION="
+if defined RAW_LINE (
+    set "CLEAN_LINE=!RAW_LINE: =!"
+    set "CLEAN_LINE=!CLEAN_LINE:*"version":"=!"
+    set "CLEAN_LINE=!CLEAN_LINE:"= !"
+    for /f "tokens=1" %%A in ("!CLEAN_LINE!") do set "VERSION=%%A"
+    set "VERSION=!VERSION:,=!"
+)
+
+set "URL_FILE=!TEMP!\url_!RANDOM!.txt"
+findstr /c:"\"url\":" "!MANIFEST_PATH!" > "!URL_FILE!" 2>nul
+set "RAW_LINE="
+set /p RAW_LINE=<"!URL_FILE!" & del "!URL_FILE!"
+set "URL="
+if defined RAW_LINE (
+    set "CLEAN_LINE=!RAW_LINE: =!"
+    set "CLEAN_LINE=!CLEAN_LINE:*"url":"=!"
+    set "CLEAN_LINE=!CLEAN_LINE:"= !"
+    for /f "tokens=1" %%A in ("!CLEAN_LINE!") do set "URL=%%A"
+    set "URL=!URL:,=!"
+)
+
+set "SHA_FILE=!TEMP!\sha_!RANDOM!.txt"
+findstr /c:"\"sha512\":" "!MANIFEST_PATH!" > "!SHA_FILE!" 2>nul
+set "RAW_LINE="
+set /p RAW_LINE=<"!SHA_FILE!" & del "!SHA_FILE!"
+set "SHA512="
+if defined RAW_LINE (
+    set "CLEAN_LINE=!RAW_LINE: =!"
+    set "CLEAN_LINE=!CLEAN_LINE:*"sha512":"=!"
+    set "CLEAN_LINE=!CLEAN_LINE:"= !"
+    for /f "tokens=1" %%A in ("!CLEAN_LINE!") do set "SHA512=%%A"
+    set "SHA512=!SHA512:,=!"
+)
+
+if not "!LOCAL_MODE!"=="true" (
+    del "!MANIFEST_PATH!"
+)
+
+if "!URL!"=="" (
+    echo Fatal: Failed to download or parse release manifest. >&2
+    exit /b 1
+)
+
+if "!LOCAL_MODE!"=="true" (
+    for /f "delims=" %%F in ("!URL!") do set "ARCHIVE_NAME=%%~nxF"
+    if /i "!ARCHIVE_NAME!"=="cli_windows_x64.exe" set "ARCHIVE_NAME=cli_windows_x64.zip"
+    set "LOCAL_ARCHIVE=!SCRIPT_DIR!packages\binaries\!ARCHIVE_NAME!"
+    if not exist "!LOCAL_ARCHIVE!" (
+        echo Fatal: Local archive !LOCAL_ARCHIVE! not found. >&2
+        exit /b 1
+    )
+    echo ✓ Local package files found for platform !PLATFORM!. Installing offline...
+)
+
+REM 3. Download/Stage & Verify Checksum
+set "STAGING_DIR=!LOCALAPPDATA!\antigravity\staging"
+if not exist "!STAGING_DIR!" mkdir "!STAGING_DIR!"
+if not exist "!STAGING_DIR!" (
+    echo Fatal: Failed to create staging directory !STAGING_DIR!. >&2
+    echo Please check write permissions for !LOCALAPPDATA!. >&2
+    exit /b 1
+)
+
+set "IS_ZIP=false"
+if /i "!URL:~-4!"==".zip" set "IS_ZIP=true"
+if defined LOCAL_ARCHIVE (
+    if /i "!LOCAL_ARCHIVE:~-4!"==".zip" set "IS_ZIP=true"
+)
+
+if "!IS_ZIP!"=="true" (
+    set "STAGING_PAYLOAD=!STAGING_DIR!\agy.zip"
+) else (
+    set "STAGING_PAYLOAD=!STAGING_DIR!\agy.exe"
+)
+
+if "!LOCAL_MODE!"=="true" (
+    echo ⠋ Staging local release package...
+    copy /y "!LOCAL_ARCHIVE!" "!STAGING_PAYLOAD!" >nul
+) else (
+    echo ⠋ Downloading release package...
+    curl -fsSL "!URL!" -o "!STAGING_PAYLOAD!"
+    if !ERRORLEVEL! neq 0 (
+        echo Fatal: Failed to download release binary from !URL!. >&2
+        echo Please check your internet connection or firewall settings. >&2
+        if exist "!STAGING_PAYLOAD!" del "!STAGING_PAYLOAD!"
+        exit /b 1
+    )
+)
+
+if "!SHA512!"=="" (
+    echo Security Halt: Checksum missing in manifest. >&2
+    del "!STAGING_PAYLOAD!" & exit /b 1
+)
+
+set "ACTUAL="
+for /f "usebackq skip=1 tokens=*" %%i in (`certutil -hashfile "!STAGING_PAYLOAD!" SHA512 2^>nul`) do (
+    if not defined ACTUAL (
+        set "ACTUAL=%%i" & set "ACTUAL=!ACTUAL: =!"
+    )
+)
+if /i not "!ACTUAL!"=="!SHA512!" (
+    echo Security Halt: Checksum verification failed. The file may be corrupted or compromised. >&2
+    del "!STAGING_PAYLOAD!" & exit /b 1
+)
+echo ✓ Release package checksum verified.
+
+REM 4. Place Binary & Unblock
+if not exist "!TARGET_DIR!" mkdir "!TARGET_DIR!"
+if not exist "!TARGET_DIR!" (
+    echo Fatal: Failed to create target directory !TARGET_DIR!. >&2
+    echo Please check directory permissions or specify a writable custom directory with --dir. >&2
+    del "!STAGING_PAYLOAD!"
+    exit /b 1
+)
+
+if "!IS_ZIP!"=="true" (
+    echo ⠋ Extracting binary from ZIP archive...
+    powershell -NoProfile -Command "Expand-Archive -Path '!STAGING_PAYLOAD!' -DestinationPath '!STAGING_DIR!' -Force"
+    if !ERRORLEVEL! neq 0 (
+        echo Fatal: Failed to extract ZIP package. >&2
+        del "!STAGING_PAYLOAD!"
+        exit /b 1
+    )
+    copy /y "!STAGING_DIR!\cli_windows_x64.exe" "!BINARY_PATH!" >nul
+    if !ERRORLEVEL! neq 0 (
+        echo Fatal: Failed to copy extracted binary. >&2
+        del "!STAGING_PAYLOAD!"
+        exit /b 1
+    )
+    del "!STAGING_DIR!\cli_windows_x64.exe" >nul 2>&1
+) else (
+    copy /y "!STAGING_PAYLOAD!" "!BINARY_PATH!" >nul
+    if !ERRORLEVEL! neq 0 (
+        echo Fatal: Failed to write binary to destination at !BINARY_PATH!. >&2
+        echo Please check directory permissions or if the file is locked, e.g. if 'agy.exe' is currently running. >&2
+        del "!STAGING_PAYLOAD!"
+        exit /b 1
+    )
+)
+ping -n 2 127.0.0.1 >nul 2>&1
+del "!STAGING_PAYLOAD!"
+del "!BINARY_PATH!:Zone.Identifier" >nul 2>&1
+
+REM 5. Go-Native Setup Handoff with Passthrough Flags
+set "SETUP_FLAGS="
+if not "!CUSTOM_DIR!"=="" set "SETUP_FLAGS=--dir "!CUSTOM_DIR!""
+set "SETUP_FLAGS=!SETUP_FLAGS! !FORWARD_ARGS!"
+
+:: Handoff safely via immune loop variables to prevent delayed expansion path mangling on '!'
+for /f "tokens=1* delims=?" %%A in ("!BINARY_PATH!?!SETUP_FLAGS!") do (
+    endlocal & endlocal
+    "%%A" install %%B
+)
+exit /b 0