Cómo instalar Antigravity CLI en Linux (Ubuntu, Debian, Fedora)

Respuesta rápida: instala Antigravity CLI en Linux en una línea

# Instalador oficial para macOS y Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
agy

Es el mismo comando que usa CodeAgentSwarm cuando instala Antigravity por ti en Linux. Todos los comandos de esta guía salen de la página oficial de primeros pasos de Antigravity CLI y de su guía de instalación y autenticación.

Requisitos

• Un Linux de 64 bits en x64 o ARM64.
• glibc 2.28 o superior y glibcxx 3.4.25 o superior. Google pone como ejemplo Ubuntu 20, Debian 10, Fedora 36 y RHEL 8.
• Bash o Zsh, y curl para lanzar el instalador.
• Una cuenta de Google. Antigravity tiene un plan gratuito, y los planes de pago de Google AI suben los límites. En máquinas sin interfaz puedes usar una API key de Gemini.

Qué hace el instalador

El script descarga el binario agy en ~/.local/bin/agy y añade esa carpeta al PATH en el perfil de tu shell. No toca directorios del sistema, así que no necesita root. Por eso también conviene abrir un terminal nuevo al acabar: el que tienes abierto aún no ha leído el perfil actualizado.

agy se actualiza solo en segundo plano, así que no hay paquete apt ni dnf que actualizar. Si prefieres controlar tú las versiones, define AGY_CLI_DISABLE_AUTO_UPDATE=true en tu entorno para desactivar el actualizador.

Antigravity guarda sus ajustes y conversaciones en ~/.gemini, la misma carpeta que usaba Gemini CLI. Si tenías Gemini CLI, el primer arranque te ofrece importar tu configuración antigua. La guía para usar Antigravity CLI explica esa importación y los comandos del día a día.

Primer arranque e inicio de sesión (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe agy. El primer arranque te pregunta el esquema de colores, el modo de renderizado y si confías en el espacio de trabajo.
• En un escritorio Linux, agy guarda tus credenciales en el keyring del sistema mediante Secret Service (GNOME Keyring o KWallet). Según el caso, inicia sesión sin preguntarte o abre el navegador con el login de Google.
• Por SSH, agy muestra una URL de inicio de sesión. Ábrela en el navegador de tu ordenador y pega en el terminal el código que te da.
• En servidores sin interfaz o en CI, exporta GEMINI_API_KEY y pon {"modelProvider": "gemini"} en ~/.gemini/antigravity-cli/settings.json.

Para cerrar sesión, ejecuta /logout dentro de agy. Desconecta tu cuenta y borra las credenciales guardadas.

Errores comunes en Linux y cómo arreglarlos

• "bash: agy: command not found" tras instalar: ~/.local/bin todavía no está en tu PATH. Abre un terminal nuevo o añade export PATH="$HOME/.local/bin:$PATH" a tu ~/.bashrc o ~/.zshrc y recárgalo con source.
• "secret keyring is locked": GNOME Keyring o KWallet está bloqueado o no responde. Desbloquéalo y, en una sesión sin interfaz o por SSH, arranca antes una sesión de D-Bus con export $(dbus-launch). En servidores, la opción de la API key evita el keyring por completo.
• "local pasteboard is empty or unreachable over SSH connection": SSH no reenvía el portapapeles por sí solo. Usa un terminal que lo soporte, como Ghostty o iTerm2, y si trabajas dentro de tmux añade set -s set-clipboard on a su configuración.
• "another background updater process is already active (update.lock)": una actualización anterior se cayó y dejó el bloqueo puesto. Bórralo con rm -f ~/.gemini/antigravity-cli/updater/update.lock y comprueba que puedes escribir en ~/.local/bin.

Para todo lo demás, consulta la página oficial de solución de problemas de Antigravity CLI.

Varias sesiones de Antigravity en Linux

Una sesión de agy ya coordina sus propios subagentes para la tarea que tiene delante. Pero un terminal sigue siendo una sola tarea. Cuando quieres una funcionalidad en un proyecto y un arreglo en otro, abres más pestañas en GNOME Terminal o en tmux, y enseguida pierdes la cuenta de qué sesión ha terminado, cuál espera tu aprobación y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio pensada justo para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o AppImage (Fedora y la mayoría de las demás distros), en x64 y ARM64. Pone varios terminales de Antigravity uno al lado del otro y añade notificaciones cuando un agente termina o necesita algo, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal. Puedes combinar agy con Claude Code, Codex y otros agentes en la misma ventana, y cada sesión sigue usando tu propia cuenta de Google.

Siguientes pasos: ejecutar múltiples sesiones de Antigravity CLI y, si también trabajas en Windows, Antigravity CLI en Windows.

Conclusión

En Linux, Antigravity CLI está a un comando curl. Comprueba tu versión de glibc, abre un terminal nuevo después de instalar e inicia sesión con el navegador, con el código por SSH o con una API key. Cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varias sesiones de agy a la vez.