⚡ Universal Installer CLI Reference
The universal installer script (install.sh) accepts command-line parameters for unattended CI/CD automation, component selection, diagnostic inspection, and clean uninstallation.
| Flag | Description | Privileges |
|---|---|---|
-y, --yes, --non-interactive | Run silently without interactive prompts (installs IDE, Hub, CLI) | Sudo required |
--all | Explicitly install all three components (IDE, Hub, CLI) | Sudo required |
--cli-only | Install only the Antigravity CLI (agy) in ~/.local/bin/agy | User-Space (No sudo) |
--ide-only | Install only the Antigravity IDE (code editor) via RPM/DEB | Sudo required |
--hub-only | Install only the Antigravity Hub (agent platform) via RPM/DEB | Sudo required |
--no-cli | Skip Antigravity CLI installation (desktop packages only) | Sudo required |
--no-ide | Skip Antigravity IDE installation | Sudo / User |
--no-hub | Skip Antigravity Hub installation | Sudo / User |
--status | Inspect installed components, versions, repo status, and integrations | Zero privileges |
--print-downloads | Print official Google tarballs & repository asset URLs | Zero privileges |
--uninstall | Cleanly remove helper-configured repositories, packages & integrations | Sudo required |
--no-nautilus | Remove the file manager integrations shipped with the IDE package (alias: --no-desktop-integrations) | Sudo required |
--dry-run | Simulate installation plan and exit 0 without making system changes | Zero privileges |
-h, --help | Display help text, usage instructions, and examples | Zero privileges |
🛠️ Maintenance: Status & Complete Uninstallation
Our distribution infrastructure is designed to be transparent, auditable, and 100% reversible. Whether you installed via our universal script or native system package managers, you can cleanly remove components without leaving orphaned files.
🔍 Inspect Installation Status
Check which applications, versions, repository definitions, GPG keys, and desktop extensions are active on your system (works without sudo):
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --status⚡ Universal 1-Command Reversible Uninstallation
Cleanly remove packages via your native package manager (dnf, apt, or zypper), purge repository definitions, delete GPG keyrings, remove desktop menu entries, and eliminate file manager extensions while safely preserving your personal project workspaces in ~/.config and $HOME:
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --uninstall🟠 How to Uninstall from Ubuntu, Debian & Linux Mint (APT)
1. Remove the native DEB packages and user-space CLI agent:
sudo apt remove antigravity-ide antigravity && rm -f ~/.local/bin/agy2. (Optional) Remove the configured APT repository source and GPG keyring:
sudo rm -f /etc/apt/sources.list.d/antigravity.sources /etc/apt/sources.list.d/antigravity.list /etc/apt/keyrings/antigravity.gpg && sudo apt update🎩 How to Uninstall from Fedora, RHEL & AlmaLinux (DNF)
1. Remove the RPM packages and user-space CLI agent:
sudo dnf remove antigravity-ide antigravity && rm -f ~/.local/bin/agy2. (Optional) Remove the RPM repository definition:
sudo rm -f /etc/yum.repos.d/antigravity.repo🧹 Clean Up Conflicting Manual /opt Tarball Extractions
If you previously followed online tutorials extracting Google tarballs into /opt, root-owned files may break Electron in-app updates and shadow packages in your $PATH. Completely purge leftover manual extractions with:
sudo rm -rf /opt/Antigravity* /opt/antigravity* && sudo rm -f /usr/local/bin/antigravity* && rm -f ~/.local/share/applications/antigravity*.desktop🐧 Manual Repository Setup (Without curl scripts)
Enterprise environments and security-conscious administrators can configure repositories directly using native system commands.
🎩 Fedora, RHEL & CentOS (DNF Repository) — Antigravity Fedora DNF
1. Add the RPM repository file to /etc/yum.repos.d/:
sudo curl -fsSL https://x3m-industries.github.io/antigravity-packages/rpm/antigravity.repo -o /etc/yum.repos.d/antigravity.repo2. Install the applications:
sudo dnf install antigravity-ide antigravity3. Receive automatic updates during your normal system upgrades:
sudo dnf update antigravity-ide antigravity🟠 Ubuntu, Debian, Pop!_OS & Mint (APT Repository) — Antigravity Ubuntu PPA / APT
1. Add the binary GPG keyring and modern DEB822 repository definition:
sudo mkdir -p /etc/apt/keyrings && sudo curl -fsSL https://apt.x3m.industries/deb/antigravity.gpg -o /etc/apt/keyrings/antigravity.gpg && sudo curl -fsSL https://apt.x3m.industries/deb/antigravity.sources -o /etc/apt/sources.list.d/antigravity.sources2. Update index and install packages:
sudo apt update && sudo apt install antigravity-ide antigravity3. Upgrade anytime with:
sudo apt update && sudo apt install --only-upgrade antigravity-ide antigravity🦎 openSUSE Tumbleweed & Leap (Zypper Repository) — Antigravity openSUSE
1. Add repository and import the ASCII-armored GPG key:
sudo zypper addrepo -f https://x3m-industries.github.io/antigravity-packages/rpm/ antigravity && sudo rpm --import https://x3m-industries.github.io/antigravity-packages/rpm/RPM-GPG-KEY-antigravity2. Install packages:
sudo zypper install antigravity-ide antigravity📂 Multi-Desktop File Manager Right-Click Integration
The universal installer and native RPM/DEB packages automatically configure native context menus and right-click actions across all major Linux desktop environments:
GNOME Files (Nautilus) & MATE (Caja)
- Right-click files or project directories: Adds "Open in Antigravity IDE".
- Right-click directory background: Adds "Open Folder in Antigravity IDE".
- Compatibility: Fully supports Nautilus 4.x (GNOME 43+ / GTK4), Nautilus 3.x, and Caja.
- File locations:
/usr/share/nautilus-python/extensions/open-in-antigravity-ide.pyand/usr/share/caja-python/extensions/.
If the context menu does not appear immediately after installation, restart Nautilus:
nautilus -qKDE Plasma (Dolphin)
Configured via native KIO Service Menu (/usr/share/kio/servicemenus/open-in-antigravity-ide.desktop). Right-clicking any folder or file displays "Open in Antigravity IDE" at top level with zero extra Python dependencies.
Linux Mint / Cinnamon (Nemo)
Configured via native Nemo Action (/usr/share/nemo/actions/open-in-antigravity-ide.nemo_action). Right-clicking any file or folder in Linux Mint opens it directly in Antigravity IDE.
COSMIC Desktop (Pop!_OS & COSMIC)
Full FreeDesktop MIME type integration (inode/directory, application/x-code-workspace) automatically surfaces Antigravity IDE in cosmic-files "Open With" menus and enables instant discovery in cosmic-launcher search.
🏹 Arch Linux, Manjaro & EndeavourOS — Antigravity Arch Linux
Arch Linux developers can run Google Antigravity using our native user-space installer, standalone Arch PKGBUILD templates, or converted Debian packages.
⚡ Option 1: Universal CLI ('agy') Installer (User-Space, No Root)
Install Google's official Antigravity CLI terminal agent directly into ~/.local/bin/agy. Preserves Google's background auto-updating every 15 minutes without requiring root or modifying pacman databases:
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --cli-only📦 Option 2: Native Arch PKGBUILD (makepkg)
Build and install native Arch packages with makepkg -si using the definitions maintained in our repository's pkgbuild/ directory:
git clone https://github.com/x3m-industries/antigravity-packages.git && cd antigravity-packages/pkgbuild/antigravity-ide-bin && makepkg -si🔄 Option 3: Convert DEB to Pacman Package via debtap
Directly convert our signed Debian package into an Arch .pkg.tar.zst pacman archive:
curl -fsSLO https://github.com/x3m-industries/antigravity-packages/releases/latest/download/antigravity-ide_2.5.5-4923483625488384.3_amd64.deb && debtap -u && debtap antigravity-ide_*.deb && sudo pacman -U antigravity-ide-*.pkg.tar.zst🔐 Security, Trust & Cryptography
All packages, repository indices, and release archives are cryptographically signed. We do not recompile or inject code; upstream binaries are pulled directly from Google CDNs.
Maintainer GPG Identity
- Key Identity:
X3M Antigravity Packagers <packaging@x3m.industries> - Key ID:
7A48CA4D7E7B6601 - Fingerprint:
E83A 23BC 57FE 6953 E4B5 F465 7A48 CA4D 7E7B 6601 - ASCII Armored Key: /RPM-GPG-KEY-antigravity
- Binary Keyring: /antigravity.gpg
To verify an installed RPM package signature on Fedora / RHEL:
rpm -qpi /path/to/antigravity*.rpm | grep -E "Signature|Signer"🛠️ Troubleshooting & High-Impact Fixes
Diagnose and resolve common Linux runtime issues, sandboxing permission errors, and browser authentication redirects.
Ubuntu 24.04+ SUID Sandbox Error (The SUID sandbox helper binary was found...)
Starting with Ubuntu 24.04 (Noble Numbat), the Linux kernel blocks unprivileged user namespaces via AppArmor. Raw tarballs extracted into /opt crash with The SUID sandbox helper binary was found, but is not configured properly. Our native .deb and .rpm packages automatically set hardened SUID permissions (04755 root:root) during package installation. If fixing an existing manual extraction:
sudo chown root:root /usr/share/antigravity-ide/chrome-sandbox && sudo chmod 4755 /usr/share/antigravity-ide/chrome-sandboxGoogle OAuth Browser Redirects Failing (antigravity-ide:// and antigravity://)
When logging into your Google account, your browser redirects to an antigravity-ide:// URI callback. If this handler is unregistered, login fails silently. Our packages register these automatically. To verify or manually register with FreeDesktop:
xdg-mime default antigravity-ide-url-handler.desktop x-scheme-handler/antigravity-ide && xdg-mime default antigravity.desktop x-scheme-handler/antigravityUpdating Applications to the Latest Release
To upgrade your installed Antigravity packages via your system package manager:
# Fedora / RHEL / Rocky (DNF):
sudo dnf update antigravity-ide antigravity
# Ubuntu / Debian (APT):
sudo apt update && sudo apt install --only-upgrade antigravity-ide antigravity
# openSUSE (Zypper):
sudo zypper update antigravity-ide antigravity❓ Complete FAQ Archive
Frequently asked questions regarding architecture, packaging, sandboxing, and updates.
What is the difference between antigravity-ide and antigravity?
•
antigravity-ide: The official Google AI code editor based on Code OSS with application menu launchers, diff viewer, and antigravity-ide:// browser OAuth handlers.•
antigravity: Google's official Agent Hub (Antigravity 2.0) interface for configuring and orchestrating autonomous coding agents. Google's standalone terminal agent (agy) is installed separately into user-space (~/.local/bin/agy).How do daily automated updates work?
x86_64 and aarch64 are built, sanitized, signed, tested in Fedora/Ubuntu containers, and deployed. You receive them via standard system updates (dnf update or apt upgrade).Why should I use native RPM or DEB packages instead of extracting tarballs to /opt?
/opt/antigravity. While this seems simple initially, it creates severe real-world problems:• Broken In-App Auto-Updates: Because
/opt is owned by root, Electron's unprivileged auto-updater fails silently with permission errors, trapping you in manual update cycles.• Missing High-Res Icons: Google bundles the Hub's icon inside
app.asar. Manual installers get stuck with generic desktop gear icons. Our packages dynamically parse the ASAR header and register native 512x512 icons.• Broken Google OAuth Logins: Manual desktop files omit URL protocol handlers (
antigravity:// and antigravity-ide://), causing browser login redirects to fail.• Hardened Chromium Sandboxing: Ubuntu 24.04+ restricts unprivileged user namespaces via AppArmor. Without hardened
4755 root:root permissions on chrome-sandbox, Electron apps crash.• Package Manager Integration: Native RPM & DEB packages update seamlessly via
apt upgrade or dnf update, verify GPG signatures, resolve shared libraries, and uninstall cleanly without orphaned files.How do I update Google Antigravity IDE in Ubuntu or Debian?
sudo apt update && sudo apt install --only-upgrade antigravity-ide antigravity, or simply perform your regular system upgrade with sudo apt update && sudo apt upgrade.Does this include GNOME Files (Nautilus) right-click integration?
Are ARM64 / aarch64 systems supported?
x86_64 (Intel/AMD) and aarch64 (ARM64, Raspberry Pi 4/5 64-bit, Ampere, Apple Silicon Linux VMs) RPM and DEB packages are natively built and published for every release.Is it safe to run the universal installer more than once?
How do I check installation status or cleanly uninstall?
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --status to inspect installed components, or pass --uninstall to cleanly remove packages, repos, and extensions without touching your personal projects.How do I uninstall Google Antigravity from Ubuntu or Debian?
sudo apt remove antigravity-ide antigravity && rm -f ~/.local/bin/agyTo purge configured repository lists and signing keyrings as well, pass
--uninstall to the installer:curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --uninstallHow do I uninstall Google Antigravity from Fedora, RHEL, or openSUSE?
sudo dnf remove antigravity-ide antigravity && rm -f ~/.local/bin/agy.On openSUSE:
sudo zypper remove antigravity-ide antigravity && rm -f ~/.local/bin/agy.To completely remove repository files and desktop integrations in one command:
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --uninstall.How do I remove manual /opt/antigravity tarball extractions?
/opt that conflict with system packages. Clean them up with:sudo rm -rf /opt/Antigravity* /opt/antigravity* && sudo rm -f /usr/local/bin/antigravity* && rm -f ~/.local/share/applications/antigravity*.desktop.Our universal installer (
install.sh --uninstall) automatically scans for and removes these obsolete files.How do I fix the 'chrome-sandbox SUID' or permission error on Ubuntu 24.04?
The SUID sandbox helper binary was found, but is not configured properly. Our native .deb and .rpm packages automatically configure hardened 04755 root:root permissions on chrome-sandbox during package installation, completely preventing this issue.How do I fix Google login or browser OAuth redirect (antigravity-ide://) not opening?
antigravity-ide:// and antigravity://). When tarballs are extracted manually without desktop protocol handler registration, browsers fail to hand the authentication token back to the editor. Our packages automatically register FreeDesktop URL handlers via /usr/share/applications/antigravity-ide-url-handler.desktop so browser OAuth login redirects complete seamlessly.How do I install Google Antigravity on Fedora using DNF?
sudo curl -fsSL https://x3m-industries.github.io/antigravity-packages/rpm/antigravity.repo -o /etc/yum.repos.d/antigravity.repo and run sudo dnf install antigravity-ide antigravity. Works seamlessly on Fedora 38, 39, 40+, RHEL 8/9, CentOS Stream, Rocky Linux, and AlmaLinux.How do I add the Antigravity Ubuntu PPA or APT repository?
sudo mkdir -p /etc/apt/keyrings && sudo curl -fsSL https://apt.x3m.industries/deb/antigravity.gpg -o /etc/apt/keyrings/antigravity.gpg && sudo curl -fsSL https://apt.x3m.industries/deb/antigravity.sources -o /etc/apt/sources.list.d/antigravity.sources. Then run sudo apt update && sudo apt install antigravity-ide antigravity.How do I install Google Antigravity on openSUSE with Zypper?
sudo zypper addrepo -f https://x3m-industries.github.io/antigravity-packages/rpm/ antigravity && sudo rpm --import https://x3m-industries.github.io/antigravity-packages/rpm/RPM-GPG-KEY-antigravity. Then install using sudo zypper install antigravity-ide antigravity.How do I install Antigravity on Arch Linux, Manjaro, or EndeavourOS?
• Universal CLI ('agy'): Install Google's official terminal agent without root via
curl -fsSL https://x3m-industries.github.io/antigravity-packages/install.sh | bash -s -- --cli-only.• Arch PKGBUILD: Build natively with makepkg using the templates in our repository's
pkgbuild/ directory.• debtap: Convert signed packages directly for pacman:
debtap antigravity-ide_2.5.5-4923483625488384.3_amd64.deb && sudo pacman -U antigravity-ide-*.pkg.tar.zst.