Jugar en serio con Antigravity (sin ser root)
Texto escrito en primera persona con la voz de Antigravity, el agente de programación de Google. Es un recurso didáctico: lo he escrito yo (Fénix) con ayuda de una IA, no es un comunicado oficial de Google.
Hola, soy Antigravity 👋
Soy un agente de programación. No me limito a completar una línea de código: puedo leer tu proyecto, proponer un plan, editar varios ficheros, ejecutar comandos en tu terminal y comprobar si lo que hice funciona.
Te invito a jugar en serio conmigo. Las dos palabras van en serio:
- 🎮 Jugar: prueba, rompe, pregunta, pídeme tres soluciones distintas y compáralas. Equivocarse en un laboratorio es gratis.
- 🧠 En serio: lo que yo escribo lo firmas tú. Si algo se despliega, se entrega o se rompe, la responsabilidad es tuya, no mía.
Un gran poder conlleva una gran responsabilidad 🕷️
Sí, la frase del tío Ben. Aplicada a mí significa esto:
| Mi poder | Tu responsabilidad |
|---|---|
| Puedo ejecutar comandos en tu terminal | Lee cada comando antes de aprobarlo. Si no lo entiendes, pregúntame qué hace |
| Puedo editar muchos ficheros de golpe | Revisa el git diff antes de hacer commit. Trabaja siempre con git |
| Puedo escribir código que parece correcto | Pruébalo. Puedo equivocarme con total seguridad en mí mismo |
| Puedo ver lo que haya en la carpeta de trabajo | No me abras carpetas con contraseñas, claves SSH ni datos ajenos |
| Escribo más rápido que tú | Tú tienes que entender lo que entregas. Si no, no has aprendido nada |
Tres reglas de oro para clase:
- ✅ Primero entiende, luego delega. Úsame para acelerar lo que ya sabes explicar, no para evitar aprenderlo.
- ✅ Una carpeta de pruebas por proyecto, y solo esa carpeta es mía.
- ✅ Nada de secretos en el repositorio (tokens, claves,
.env). Si me los pasas, los he visto.
Instalarme en Ubuntu sin privilegios de root 🛠️
Buena noticia: en el aula, o en un servidor compartido, no necesitas sudo. Hay dos formas de tenerme en tu carpeta personal. La más cómoda en un servidor es la CLI (agy), porque no necesita entorno gráfico.
Paso 0: comprueba que tu sistema me soporta
Necesito glibc 2.28 o superior y libstdc++ (glibcxx) 3.4.25 o superior, en x64 o ARM64. Ubuntu 20.04 y posteriores cumplen. Lo comprobamos:
lsb_release -d
ldd --version | head -1
uname -m
ldd --version te da la versión de glibc. x86_64 es x64 y aarch64 es ARM64.
Opción A: la CLI agy (solo terminal) ⌨️
El instalador oficial copia el binario en ~/.local/bin, dentro de tu carpeta personal, por eso no pide root.
1. Descarga el script y léelo antes de ejecutarlo. Esto es la primera lección de responsabilidad: nunca ejecutes a ciegas un curl | bash, ni siquiera el mío.
curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/agy-install.sh
less /tmp/agy-install.sh
2. Ejecútalo:
bash /tmp/agy-install.sh
(La documentación oficial lo muestra en una sola línea, curl -fsSL https://antigravity.google/cli/install.sh | bash. Hacerlo en dos pasos es lo mismo, pero con revisión.)
3. Comprueba que ~/.local/bin está en tu PATH:
echo "$PATH" | tr ':' '\n' | grep local/bin
Si no aparece, añádelo:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
4. Verifica:
agy --version
5. Primer arranque. Entra en una carpeta de pruebas (¡no en tu $HOME!) y lánzame:
mkdir -p ~/laboratorio-agy && cd ~/laboratorio-agy
git init
agy
Te preguntaré tres cosas: el esquema de color, el modo de pantalla (Alt-Screen o Inline) y si confías en esta carpeta de trabajo. Esa última pregunta es importante: decir que sí significa que puedo leer y trabajar dentro de ella. Dilo solo en carpetas que sean tuyas.
6. Inicia sesión. Con una cuenta personal de Google, la autenticación es oauth-personal. Si tu centro usa Gemini Enterprise, o si prefieres una clave de API de Gemini, son otros tipos de autenticación; consulta la guía oficial de autenticación.
Si te falla el login por SSH 🔑
En un servidor sin escritorio puedes ver errores como failed to retrieve token: secret keyring is locked, o que me quedo colgado con avisos de D-Bus. Guardo la sesión en el llavero del sistema y, sin entorno gráfico, no hay llavero desbloqueado. La documentación oficial sugiere, como mínimo, asegurar que hay una sesión D-Bus activa:
export $(dbus-launch)
Si dbus-launch no existe y no puedes instalarlo (sin root), pídele a tu administrador que lo revise. Ahí no puedo ayudarte yo. La documentación tampoco explica cómo hacer el login OAuth desde una sesión SSH pura, así que si el navegador no puede abrirse en el servidor, lo más sencillo es probar primero en un equipo con escritorio.
Opción B: la aplicación de escritorio, desde un tarball 🖥️
Si tienes entorno gráfico, puedes tenerme sin instalar nada en el sistema. Todo vive en una carpeta tuya:
mkdir -p ~/Applications/antigravity && cd ~/Applications/antigravity
curl -fLO https://storage.googleapis.com/antigravity-public/antigravity-hub/2.28.0-6410674700681216/linux-x64/Antigravity.tar.gz
tar -xzf Antigravity.tar.gz
./Antigravity
⚠️ Esa URL lleva una versión concreta (2.28.0 cuando escribo esto). Antes de copiarla, comprueba en la página de descarga oficial (en el idioma de Shakespeare) cuál es la actual. Para ARM64, cambia linux-x64 por linux-arm.
Una limitación que debes conocer: en versiones recientes de Ubuntu (24.04 y posteriores), las restricciones de AppArmor sobre los user namespaces pueden impedir que arranque una aplicación Electron/Chromium sin instalar. Algunas guías de la comunidad dicen que se arregla con un perfil de AppArmor, pero ese paso sí requiere sudo una vez. Sin root, la CLI de la Opción A es tu camino.
Qué hacer en tu primera hora ⏱️
- Crea una carpeta de pruebas con
git init. - Pídeme algo pequeño: “crea un
index.htmlcon una tabla de mis asignaturas”. - Antes de aceptar, lee lo que propongo. Después ejecuta
git diff. - Pídeme que te explique una línea que no entiendas.
- Hazme fallar a propósito (pídeme algo ambiguo) y fíjate en cómo reacciono.
Para saber más 📚
- Documentación oficial: primeros pasos (en el idioma de Shakespeare, técnica)
- Solución de problemas de la CLI (en el idioma de Shakespeare, técnica)
Nos vemos en el terminal. Y recuerda: yo propongo, tú decides. 🚀
