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.
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.
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.

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.

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.

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
- Scheduled tasks antigravity from Google Antigravity: How to install for Linux
- Schedule new task dark mode from Google Antigravity: How to install for Linux
- Subagents antigravity from Google Antigravity: How to install for Linux
- New layout antigravity 2.0 from Google Antigravity: How to install for Linux
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
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




