How to Install Google Antigravity on Linux – App, IDE & CLI

Share

The quickest way to install Google Antigravity on Ubuntu is the CLI: run curl -fsSL https://antigravity.google/cli/install.sh | bash and type agy in a project folder. For a desktop window, install the Antigravity app or the Antigravity IDE from Google’s Linux tarballs, or add the official extension to VS Code, JetBrains or Zed.

This guide covers all four on Ubuntu 26.04 and 24.04, with helper scripts that install and update the tarballs, the keyring, AppArmor and black-window fixes, and clean removal. If any of these steps fail on your system, please drop a comment below or contact us and we will help you get it resolved.

Requirements at a Glance
• Ubuntu: 26.04 LTS or 24.04 LTS, amd64 or arm64
• Antigravity app: about 180 MB download, installs to /opt/antigravity
• Antigravity IDE: about 240 MB download, installs to /opt/antigravity-ide
• CLI: one binary in ~/.local/bin that updates itself
• Account: a Google Account; the free plan works
• Keyring: GNOME Keyring or another Secret Service to remember your sign-in

Ubuntu 26.04 & 24.04  ·  Developer Guide
Google Antigravity on Ubuntu

App, IDE, CLI & Extensions

Install Google’s agent coding tools on Ubuntu: the Antigravity app, the standalone IDE, the agy CLI, or the extension for the editor you already use.

Target OS: Ubuntu 24.04 / 26.04 LTS
Arch Support: amd64 / arm64
Extensions: VS Code, JetBrains, Zed
Price: Free plan available

Install the Antigravity App in 3 Steps

You only need one of these. The app runs agents across your projects, the IDE is a full editor, the CLI does the same work in a terminal, and the extensions add it to an editor you already use. There is a comparison further down.

Google ships the app for Linux as a tarball, not an apt package. The helper script below installs it, and running it again updates it.

Step 1. Install the tools the helper script needs:

sudo apt update
sudo apt install curl tar desktop-file-utils python3 -y

Step 2. Create the helper script. It detects your architecture, finds the current tarball on Google’s download page, installs it under /opt/antigravity, sets up the Chromium sandbox helper and registers the launcher:

sudo tee /usr/local/bin/update-antigravity > /dev/null <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
if [ "$(id -u)" -ne 0 ]; then
	echo "Run with sudo: sudo update-antigravity" >&2
	exit 1
fi
download_page="https://antigravity.google/download"
install_root="/opt/antigravity"
command_link="/usr/local/bin/antigravity"
desktop_file="/usr/share/applications/antigravity.desktop"
icon_file="/usr/share/icons/hicolor/512x512/apps/antigravity.png"
old_icon_file="/usr/share/icons/hicolor/scalable/apps/antigravity.svg"
case "$(uname -m)" in
x86_64 | amd64) platform="linux-x64" ;;
aarch64 | arm64) platform="linux-arm" ;;
*)
	echo "Unsupported architecture: $(uname -m)" >&2
	exit 1
	;;
esac
for required_command in curl tar python3; do
	if ! command -v "$required_command" >/dev/null 2>&1; then
		echo "$required_command is required to install Antigravity." >&2
		exit 1
	fi
done
if [ -L "$command_link" ]; then
	command_target=$(readlink -f "$command_link" || true)
	case "$command_target" in
	"$install_root"/*) ;;
	*)
		echo "$command_link points to $command_target. Move it before rerunning this helper." >&2
		exit 1
		;;
	esac
elif [ -e "$command_link" ]; then
	echo "$command_link exists and is not a symlink. Move it before rerunning this helper." >&2
	exit 1
fi
tmp_parent="${TMPDIR:-/var/tmp}"
mkdir -p "$tmp_parent"
tmpdir=$(mktemp -d "$tmp_parent/antigravity.XXXXXX")
trap 'rm -rf "$tmpdir"' EXIT
download_html="$tmpdir/download.html"
archive="$tmpdir/Antigravity.tar.gz"
archive_list="$tmpdir/archive-list.txt"
icon_staged="$tmpdir/antigravity.png"
curl -fsSL --compressed --retry 3 -o "$download_html" "$download_page"
download_url=$(grep -oE "https://[A-Za-z0-9./_-]+/antigravity-hub/[0-9][0-9A-Za-z.-]*/${platform}/Antigravity\.tar\.gz" "$download_html" | awk 'NR==1' || true)
if [ -z "$download_url" ]; then
	echo "Could not find a Linux download on $download_page." >&2
	exit 1
fi
version=$(printf '%s\n' "$download_url" | sed -E 's#.*/antigravity-hub/([0-9.]+)-.*#\1#')
case "$platform" in
linux-x64) expected_top_dir="Antigravity-x64" ;;
linux-arm) expected_top_dir="Antigravity-arm64" ;;
esac
expected_target="$install_root/$expected_top_dir/antigravity"
sandbox_path="$install_root/$expected_top_dir/chrome-sandbox"
installed_version=$(cat "$install_root/.installed-version" 2>/dev/null || true)
desktop_matches=no
if [ -f "$desktop_file" ] &&
	grep -q '^Icon=antigravity$' "$desktop_file" &&
	grep -q '^StartupWMClass=Antigravity$' "$desktop_file"; then
	desktop_matches=yes
fi
if [ "$installed_version" = "$version" ] &&
	[ -x "$expected_target" ] &&
	[ -L "$command_link" ] &&
	[ "$(readlink -f "$command_link")" = "$expected_target" ] &&
	[ "$desktop_matches" = yes ] &&
	[ -f "$icon_file" ]; then
	if [ ! -e "$sandbox_path" ] || [ "$(stat -c '%U:%G:%a' "$sandbox_path")" = "root:root:4755" ]; then
		printf 'Antigravity %s is already installed at %s\n' "$version" "$install_root/$expected_top_dir"
		exit 0
	fi
fi
printf 'Downloading Antigravity %s for %s...\n' "$version" "$platform"
curl -fsSL --retry 3 -o "$archive" "$download_url"
tar -tzf "$archive" >"$archive_list"
top_dir=$(sed -n '1{s#/.*##;p;q}' "$archive_list")
case "$top_dir" in
Antigravity-*) ;;
*)
	echo "Unexpected archive layout: $top_dir" >&2
	exit 1
	;;
esac
if [ "$top_dir" != "$expected_top_dir" ]; then
	echo "Unexpected archive directory: $top_dir" >&2
	exit 1
fi
tar -xzf "$archive" -C "$tmpdir"
if [ ! -x "$tmpdir/$top_dir/antigravity" ]; then
	echo "The Antigravity launcher was not found in the archive." >&2
	exit 1
fi
python3 - "$tmpdir/$top_dir/resources/app.asar" "$icon_staged" <<'PY'
import json
import struct
import sys
from pathlib import Path
asar = Path(sys.argv[1])
output = Path(sys.argv[2])
with asar.open("rb") as archive:
    archive.read(4)
    header_size = struct.unpack("<I", archive.read(4))[0]
    archive.read(4)
    json_size = struct.unpack("<I", archive.read(4))[0]
    header = json.loads(archive.read(json_size).decode())
icon = header["files"]["icon.png"]
with asar.open("rb") as archive:
    archive.seek(8 + header_size + int(icon["offset"]))
    output.write_bytes(archive.read(int(icon["size"])))
PY
rm -rf "${install_root}.new"
mkdir -p "${install_root}.new"
cp -a "$tmpdir/$top_dir" "${install_root}.new/"
printf '%s\n' "$version" >"${install_root}.new/.installed-version"
if [ -f "${install_root}.new/$top_dir/chrome-sandbox" ]; then
	chown root:root "${install_root}.new/$top_dir/chrome-sandbox"
	chmod 4755 "${install_root}.new/$top_dir/chrome-sandbox"
fi
if [ -d "$install_root" ]; then
	rm -rf "${install_root}.previous"
	mv "$install_root" "${install_root}.previous"
fi
mv "${install_root}.new" "$install_root"
ln -sfn "$install_root/$top_dir/antigravity" "$command_link"
mkdir -p "$(dirname "$icon_file")"
install -m 0644 "$icon_staged" "$icon_file"
rm -f "$old_icon_file"
tee "$desktop_file" >/dev/null <<DESKTOP
[Desktop Entry]
Name=Antigravity
Comment=Google Antigravity agent platform
Exec=$command_link %U
Icon=antigravity
Terminal=false
Type=Application
Categories=Development;IDE;
StartupNotify=true
StartupWMClass=Antigravity
DESKTOP
if command -v update-desktop-database >/dev/null 2>&1; then
	update-desktop-database /usr/share/applications >/dev/null 2>&1 || true
fi
if command -v gtk-update-icon-cache >/dev/null 2>&1; then
	gtk-update-icon-cache -q /usr/share/icons/hicolor 2>/dev/null || true
fi
printf 'Installed Antigravity %s at %s\n' "$version" "$install_root/$top_dir"
EOF
sudo chmod +x /usr/local/bin/update-antigravity

Step 3. Run it. Run the same command again any time to update:

sudo update-antigravity

Verify that the launcher symlink, desktop configuration, and icons are in place:

readlink -f /usr/local/bin/antigravity
grep -E '^(Name|Exec|Icon|Categories|StartupWMClass)=' /usr/share/applications/antigravity.desktop
test -f /usr/share/icons/hicolor/512x512/apps/antigravity.png && echo "Icon verified"

Verify AppArmor and Sandbox State

Ubuntu restricts unprivileged user namespaces. The script gives chrome-sandbox root ownership and 4755 permissions so the app runs without disabling AppArmor system-wide. Confirm it took:

sysctl -n kernel.apparmor_restrict_unprivileged_userns 2>/dev/null || echo "Not restricted"
stat -c '%U %G %a %n' /opt/antigravity/Antigravity-*/chrome-sandbox

Install the Antigravity IDE in 3 Steps

The IDE is a VS Code fork with the agent panels built in. The script installs it under /opt/antigravity-ide/Antigravity-IDE. Gemini 4 Argon does not run in the standalone IDE. If you want it, use the app, the CLI or an extension instead.

Step 1. If you skipped the app, install curl first with sudo apt install curl -y. Step 2. Create the IDE helper script:

sudo tee /usr/local/bin/update-antigravity-ide > /dev/null <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
if [ "$(id -u)" -ne 0 ]; then
	echo "Run with sudo: sudo update-antigravity-ide" >&2
	exit 1
fi
download_page="https://antigravity.google/download"
install_root="/opt/antigravity-ide"
command_link="/usr/local/bin/antigravity-ide"
desktop_file="/usr/share/applications/antigravity-ide.desktop"
icon_file="/usr/share/icons/hicolor/512x512/apps/antigravity-ide.png"
archive_top_dir="Antigravity IDE"
install_dir="Antigravity-IDE"
case "$(uname -m)" in
x86_64 | amd64) platform="linux-x64" ;;
aarch64 | arm64) platform="linux-arm" ;;
*)
	echo "Unsupported architecture: $(uname -m)" >&2
	exit 1
	;;
esac
for required_command in curl tar; do
	if ! command -v "$required_command" >/dev/null 2>&1; then
		echo "$required_command is required to install Antigravity IDE." >&2
		exit 1
	fi
done
if [ -L "$command_link" ]; then
	command_target=$(readlink -f "$command_link" || true)
	case "$command_target" in
	"$install_root"/*) ;;
	*)
		echo "$command_link points to $command_target. Move it before rerunning this helper." >&2
		exit 1
		;;
	esac
elif [ -e "$command_link" ]; then
	echo "$command_link exists and is not a symlink. Move it before rerunning this helper." >&2
	exit 1
fi
tmp_parent="${TMPDIR:-/var/tmp}"
mkdir -p "$tmp_parent"
tmpdir=$(mktemp -d "$tmp_parent/antigravity-ide.XXXXXX")
trap 'rm -rf "$tmpdir"' EXIT
download_html="$tmpdir/download.html"
archive="$tmpdir/Antigravity-IDE.tar.gz"
archive_list="$tmpdir/archive-list.txt"
curl -fsSL --compressed --retry 3 -o "$download_html" "$download_page"
download_url=$(grep -oE "https://[A-Za-z0-9./_-]+/stable/[0-9][0-9A-Za-z.-]*/${platform}/Antigravity%20IDE\.tar\.gz" "$download_html" | awk 'NR==1' || true)
if [ -z "$download_url" ]; then
	echo "Could not find a Linux IDE download on $download_page." >&2
	exit 1
fi
version=$(printf '%s\n' "$download_url" | sed -E 's#.*/stable/([0-9.]+)-.*#\1#')
expected_target="$install_root/$install_dir/antigravity-ide"
sandbox_path="$install_root/$install_dir/chrome-sandbox"
installed_version=$(cat "$install_root/.installed-version" 2>/dev/null || true)
desktop_matches=no
if [ -f "$desktop_file" ] &&
	grep -q '^Icon=antigravity-ide$' "$desktop_file" &&
	grep -q '^StartupWMClass=antigravity-ide$' "$desktop_file"; then
	desktop_matches=yes
fi
if [ "$installed_version" = "$version" ] &&
	[ -x "$expected_target" ] &&
	[ -L "$command_link" ] &&
	[ "$(readlink -f "$command_link")" = "$expected_target" ] &&
	[ "$desktop_matches" = yes ] &&
	[ -f "$icon_file" ]; then
	if [ ! -e "$sandbox_path" ] || [ "$(stat -c '%U:%G:%a' "$sandbox_path")" = "root:root:4755" ]; then
		printf 'Antigravity IDE %s is already installed at %s\n' "$version" "$install_root/$install_dir"
		exit 0
	fi
fi
printf 'Downloading Antigravity IDE %s for %s...\n' "$version" "$platform"
curl -fsSL --retry 3 -o "$archive" "$download_url"
tar -tzf "$archive" >"$archive_list"
top_dir=$(sed -n '1{s#/.*##;p;q}' "$archive_list")
if [ "$top_dir" != "$archive_top_dir" ]; then
	echo "Unexpected archive directory: $top_dir" >&2
	exit 1
fi
tar -xzf "$archive" -C "$tmpdir"
if [ ! -x "$tmpdir/$archive_top_dir/antigravity-ide" ]; then
	echo "The Antigravity IDE launcher was not found in the archive." >&2
	exit 1
fi
icon_source="$tmpdir/$archive_top_dir/resources/app/resources/linux/code.png"
if [ ! -f "$icon_source" ]; then
	echo "The Antigravity IDE icon was not found in the archive." >&2
	exit 1
fi
rm -rf "${install_root}.new"
mkdir -p "${install_root}.new/$install_dir"
cp -a "$tmpdir/$archive_top_dir/." "${install_root}.new/$install_dir/"
printf '%s\n' "$version" >"${install_root}.new/.installed-version"
if [ -f "${install_root}.new/$install_dir/chrome-sandbox" ]; then
	chown root:root "${install_root}.new/$install_dir/chrome-sandbox"
	chmod 4755 "${install_root}.new/$install_dir/chrome-sandbox"
fi
if [ -d "$install_root" ]; then
	rm -rf "${install_root}.previous"
	mv "$install_root" "${install_root}.previous"
fi
mv "${install_root}.new" "$install_root"
ln -sfn "$install_root/$install_dir/antigravity-ide" "$command_link"
mkdir -p "$(dirname "$icon_file")"
install -m 0644 "$icon_source" "$icon_file"
tee "$desktop_file" >/dev/null <<DESKTOP
[Desktop Entry]
Name=Antigravity IDE
Comment=Google Antigravity IDE
Exec=$command_link %U
Icon=antigravity-ide
Terminal=false
Type=Application
Categories=Development;IDE;
MimeType=x-scheme-handler/antigravity-ide;application/x-antigravity-workspace;
StartupNotify=true
StartupWMClass=antigravity-ide
DESKTOP
if command -v update-desktop-database >/dev/null 2>&1; then
	update-desktop-database /usr/share/applications >/dev/null 2>&1 || true
fi
if command -v gtk-update-icon-cache >/dev/null 2>&1; then
	gtk-update-icon-cache -q /usr/share/icons/hicolor 2>/dev/null || true
fi
printf 'Installed Antigravity IDE %s at %s\n' "$version" "$install_root/$install_dir"
EOF
sudo chmod +x /usr/local/bin/update-antigravity-ide

Step 3. Run it. Run it again later to update:

sudo update-antigravity-ide

Check the launcher and the sandbox permissions:

readlink -f /usr/local/bin/antigravity-ide
grep -E '^(Name|Exec|Icon|Categories|StartupWMClass)=' /usr/share/applications/antigravity-ide.desktop
stat -c '%U %G %a %n' /opt/antigravity-ide/Antigravity-IDE/chrome-sandbox

Install the Antigravity CLI in 2 Steps

The Antigravity CLI is a terminal app called agy. You open it inside a project folder and give it tasks, the same way you would in the app.

Step 1. Make sure curl is installed:

sudo apt update
sudo apt install curl -y

Step 2. Run Google’s installer. It puts agy in ~/.local/bin and adds that folder to your PATH:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Open a new terminal and check the version:

agy --version

The CLI updates itself in the background. To update by hand, run agy update. If the terminal says agy: command not found, see Troubleshooting.

Use Antigravity in VS Code, JetBrains or Zed

If you already have an editor you like, the official extension adds Antigravity’s agent panel to it. Sign in with the same Google account you would use for the app.

VS Code

You need VS Code 1.90 or newer. If you do not have it yet, see how to install VS Code on Ubuntu. Then install the extension:

code --install-extension Google.google-antigravity

Click the Antigravity icon in the Activity Bar to sign in. On first launch the extension installs the agy backend for you.

Antigravity extension in VS Code with the agent panel beside a generated project review
The Antigravity extension in VS Code, with the agent panel on the left. Image: Google

JetBrains IDEs

IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, Rider and the other IntelliJ-based IDEs are supported from version 2026.2.1. Open JetBrains AI > Settings > Agents, search for Antigravity, and click Install.

Zed

Press Ctrl+Shift+P, run agent: open settings, then go to External Agents > Add > Install from Registry. Search for Antigravity and click Install.

Which One Should You Install?

All four use the same Google account and the same plan. Pick by where you like to work:

Antigravity app Antigravity IDE CLI (agy) Extension
What it is Desktop window for running agents on your projects VS Code-based editor with agent panels Agent in your terminal Agent panel inside your current editor
Best for Handing off tasks and reviewing the results Writing code and watching the agent edit it Terminal users, SSH and servers People happy with VS Code, JetBrains or Zed
Install Tarball and helper script Tarball and helper script Google’s install script From the editor’s extension store
Gemini 4 Argon Yes No Yes Yes
Updates Rerun the helper Rerun the helper Automatic Through the editor

First Launch and Sign-In

Start the app or the IDE from Activities, or from a terminal.

Launch the Antigravity App

antigravity

Sign in with your personal Google Account, or choose Business account for Gemini Enterprise. Then create a project: click the folder icon with a + in the sidebar, choose New Project, add one or more folders, and click Create.

When you start a task, pick Local to let the agent work in your folders directly, or New Worktree to keep its changes in a separate Git worktree.

Antigravity app new chat box with the Local and New Worktree mode picker open
A new task in the Antigravity app, with the Local and New Worktree picker open. Image: Google

Launch the Antigravity IDE

antigravity-ide

Start the CLI

Change into a project folder and run agy:

cd ~/projects/my-app
agy

The first time, it opens your browser to sign in, then asks for a color scheme, a display mode, and whether you trust the folder.

Antigravity CLI first launch screen asking the user to choose a color scheme
The Antigravity CLI on first launch, asking for a color scheme. Image: Google

Over SSH, agy prints a sign-in link instead. Open it in a browser on any computer, sign in, and paste the code it shows back into the terminal.

For scripts and CI with no browser, use a Gemini API key from Google AI Studio. If you have no CLI settings file yet, this creates one:

mkdir -p ~/.gemini/antigravity-cli
echo '{ "modelProvider": "gemini" }' > ~/.gemini/antigravity-cli/settings.json
export GEMINI_API_KEY="your-api-key"
agy

Inside agy, type / to see every command. These are the ones you will use most:

Command What it does
/help Shows commands and keyboard shortcuts
/model Picks the model, such as Gemini 4 Argon, and remembers it next time
/resume Opens an earlier conversation
/diff Shows the changes the agent made
/permissions Sets what the agent may run without asking
/usage Shows how much of your quota is left
/logout Signs out and removes the saved token from your keyring

Use Gemini 4 Argon in Antigravity

Gemini 4 Argon is Google’s newest model in Antigravity. It runs in the Antigravity app, the CLI and the VS Code, JetBrains and Zed extensions, but not in the standalone IDE.

You need a Google AI Ultra plan or an eligible Gemini Enterprise subscription. The free plan uses Gemini 3.8 Flash, which works the same way for everything in this guide.

In the app, pick Gemini 4 Argon from the model menu under the message box. In the CLI, type /model and choose it there. If it is missing from the list, check which plan your Google account is on.

Google Antigravity Screenshots

Google Antigravity Beginner’s Guide (Video)

Google’s own walkthrough of the basics, from the Google Antigravity YouTube channel:

Troubleshooting

Seven things go wrong often enough on Linux to be worth naming. Each one below is a symptom and a fix.

agy: command not found

The installer adds ~/.local/bin to your PATH, but only new terminals see it. Open a new terminal first. If it still fails, add the folder yourself:

grep -qxF 'export PATH="$HOME/.local/bin:$PATH"' ~/.bashrc || echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

The Keyring Authentication Loop (libsecret Failures)

In an SSH session, WSL2 or a minimal window manager, agy asks you to sign in every time, or stops with secret keyring is locked. The Secret Service keyring is not running in that shell.

To resolve this authentication loop, install the required D-Bus and Gnome Keyring daemon packages:

sudo apt update
sudo apt install -y dbus-x11 libsecret-1-0 gnome-keyring

Then have D-Bus and the keyring start with your shell. Append this to ~/.bashrc:

# Start keyring and D-Bus for session persistence
if [ -n "$BASH_VERSION" ]; then
  export $(dbus-launch)
  eval "$(echo "" | gnome-keyring-daemon --unlock)"
  eval "$(gnome-keyring-daemon --start)"
  export SSH_AUTH_SOCK
fi

AppArmor Restrictions and IDE Crashes

On Ubuntu 24.04 and 26.04 the IDE can exit the moment it starts, because AppArmor puts Electron under its restricted user namespace profile. Check the kernel log:

sudo journalctl -k --since "10 minutes ago" --no-pager | grep -iE 'apparmor.*antigravity-ide|trap.*antigravity-ide'

If you see an unprivileged_userns entry for the IDE, give the executable its own AppArmor profile rather than loosening the system-wide setting:

sudo install -d -m 0755 /etc/apparmor.d/local
if [ -f /etc/apparmor.d/abi/5.0 ]; then
  apparmor_abi="5.0"
elif [ -f /etc/apparmor.d/abi/4.0 ]; then
  apparmor_abi="4.0"
else
  apparmor_abi=""
fi
if [ -n "$apparmor_abi" ]; then
  sudo touch /etc/apparmor.d/local/antigravity-ide
  sudo tee /etc/apparmor.d/antigravity-ide > /dev/null <<EOF
abi <abi/${apparmor_abi}>,
include <tunables/global>
profile antigravity-ide "/opt/antigravity-ide/Antigravity-IDE/antigravity-ide" flags=(unconfined) {
  userns,
  "/opt/antigravity-ide/Antigravity-IDE/antigravity-ide" mr,
  include if exists <local/antigravity-ide>
}
EOF
  sudo apparmor_parser -r /etc/apparmor.d/antigravity-ide
fi

Black Desktop or IDE Window (Wayland GPU Bugs)

A window that opens black is usually Electron’s GPU acceleration against your Wayland session. Test with it off:

antigravity --disable-gpu
antigravity-ide --disable-gpu

If Wayland still drops the graphics rendering context, force the apps to fall back to an Xwayland session:

ELECTRON_OZONE_PLATFORM_HINT=x11 antigravity --disable-gpu
ELECTRON_OZONE_PLATFORM_HINT=x11 antigravity-ide --disable-gpu

Running Inside Virtual Machines (VirtualBox, QEMU/KVM, VMware)

Inside a virtual machine the apps may not launch, may show black, or may crawl, because VM graphics drivers drop the GPU context Electron expects. Per-hypervisor fixes:

For VirtualBox:

  • Ensure 3D Acceleration is enabled in the VM settings under Display.
  • Install the guest additions inside the guest OS: sudo apt install virtualbox-guest-x11.
  • If the window remains black, run the launchers with the software rendering override: LIBGL_ALWAYS_SOFTWARE=1 antigravity.

For QEMU/KVM (Virt-Manager & GNOME Boxes):

  • In Virt-Manager, select the VM’s Video Virtio hardware device and check the box for 3D Acceleration.
  • Under the Display Spice hardware entry, set Listen Type to None and check the box for OpenGL.
  • Install the spice guest agents: sudo apt install spice-vdagent.

For VMware Workstation & Player:

  • Enable Accelerate 3D graphics in your Virtual Machine Settings under Display.
  • Update the guest Mesa drivers, or set mks.enable3d = “FALSE” in the VM’s .vmx file to turn off 3D at the hypervisor.

URI Scheme Callback Redirections (antigravity:// Conflicts)

An old desktop entry can swallow the antigravity:// or antigravity-ide:// callback, so sign-in never returns to the CLI. Check what is registered:

xdg-settings get default-url-scheme-handler antigravity
xdg-settings get default-url-scheme-handler antigravity-ide

If the query returns a legacy configuration file, remove the stale links or update the scheme pointers under ~/.config/mimeapps.list or ~/.local/share/applications/.

CLI Will Not Update (update.lock)

If agy hangs at start or warns that another updater is already active, a background update crashed and left its lock behind. Remove it:

rm -f ~/.gemini/antigravity-cli/updater/update.lock

To turn automatic updates off and update by hand with agy update, add this to ~/.bashrc:

export AGY_CLI_DISABLE_AUTO_UPDATE=true

Start Over With a Clean Sign-In

If sign-in or settings are badly stuck, type /logout inside agy, then delete the CLI’s settings folder and start again:

rm -rf ~/.gemini/antigravity-cli
agy

How to Uninstall Google Antigravity

Remove only what you installed. To remove an extension, uninstall it from your editor’s extension list.

Uninstall the Antigravity App

Delete the installation directories, desktop entry, command link, icon, and helper files:

sudo rm -rf /opt/antigravity /opt/antigravity.previous /opt/antigravity.new
sudo rm -f /usr/local/bin/antigravity
sudo rm -f /usr/local/bin/update-antigravity
sudo rm -f /usr/share/applications/antigravity.desktop /usr/share/applications/antigravity-x11.desktop
sudo rm -f /usr/share/icons/hicolor/512x512/apps/antigravity.png
sudo update-desktop-database /usr/share/applications || true

Uninstall the Antigravity IDE

Remove the installation folders, symlink, helpers, app launcher, and optional AppArmor profile:

sudo rm -rf /opt/antigravity-ide /opt/antigravity-ide.previous /opt/antigravity-ide.new
sudo rm -f /usr/local/bin/antigravity-ide
sudo rm -f /usr/local/bin/update-antigravity-ide
sudo rm -f /usr/share/applications/antigravity-ide.desktop /usr/share/applications/antigravity-ide-x11.desktop
sudo rm -f /usr/share/icons/hicolor/512x512/apps/antigravity-ide.png
if [ -f /etc/apparmor.d/antigravity-ide ]; then
  sudo apparmor_parser -R /etc/apparmor.d/antigravity-ide || true
  sudo rm -f /etc/apparmor.d/antigravity-ide /etc/apparmor.d/local/antigravity-ide
fi
sudo update-desktop-database /usr/share/applications || true

Uninstall the Antigravity CLI

Remove the binary and, if you want, its settings:

rm -f "$HOME/.local/bin/agy" "$HOME/.local/bin/update-antigravity-cli"
rm -rf "$HOME/.gemini/antigravity-cli"
hash -r

Helpful Resources

Antigravity documentation ↗Google’s guides for the app, CLI, IDE and extensions.
Antigravity changelog ↗What changed in each release, per product.
Antigravity support ↗Google’s help options and community links.
r/GoogleAntigravity ↗Other users comparing setups and fixes.

Frequently Asked Questions

What is the difference between the Antigravity app, IDE and CLI?

The app is a desktop window for running agents across your projects, the IDE is a VS Code-based editor with agent panels, and the CLI (agy) runs agents in a terminal. All three use the same Google account and plan.

Can I use Google Antigravity in VS Code on Linux?

Yes. Install the Google Antigravity extension from the VS Code Marketplace, which needs VS Code 1.90 or newer. It sets up the agy backend on first launch. JetBrains IDEs and Zed have official extensions too.

Can I use Gemini 4 Argon in Antigravity on Linux?

Yes, in the Antigravity app, the CLI and the VS Code, JetBrains and Zed extensions, with a Google AI Ultra plan or an eligible Gemini Enterprise subscription. It is not available in the standalone Antigravity IDE.

Why does the Antigravity CLI keep asking me to sign in on Linux?

agy saves its sign-in in the Secret Service keyring. Over SSH or in a minimal session no keyring is running, so it cannot read the token. Install gnome-keyring and dbus-x11 and start them from ~/.bashrc, as shown in the troubleshooting section.

How do I fix the Antigravity IDE closing right after it opens on Ubuntu?

Ubuntu’s AppArmor blocks the user namespaces the IDE needs. Give the IDE its own AppArmor profile with userns access, as shown in the troubleshooting section, rather than turning the restriction off for the whole system.

Is there a Snap, Flatpak or apt package for Google Antigravity?

No. Google ships the app and the IDE as tarballs and the CLI as an install script. An old apt repository still exists, but it only carries an outdated 1.x version of the IDE.

Is Google Antigravity free?

Yes. Every Google account gets a free plan with a weekly quota that uses Gemini 3.8 Flash. Paid Google AI plans raise the limits, and Google AI Ultra adds Gemini 4 Argon. The app, IDE, CLI and extensions are all included.

More Linux development guides: Visual Studio Code  ·  Docker Setup  ·  PowerShell for Linux

Related guides: Install ChatGPT on Ubuntu · Install Claude Desktop on Ubuntu · Install Cursor on Ubuntu · Install Grok Bot on Ubuntu · Install Visual Studio Code on Ubuntu · Install Devin Desktop on Ubuntu · More AI guides for Ubuntu