Ya tienes Antigravity instalado. Ahora necesitas entender cómo funciona en la práctica: qué es un Proyecto, cómo lanzar un agente, cómo revisar sus cambios antes de que los aplique, y cómo sacar el máximo provecho sin perder el control. Esta guía lo explica desde cero.
Si aún no tienes Antigravity instalado, empieza por nuestra guía de instalación.
El concepto clave: Proyectos
En Antigravity, todo gira alrededor del Proyecto. Un Proyecto es la configuración que define qué carpetas puede ver y modificar el agente, qué permisos tiene y qué herramientas están disponibles. Puedes tener múltiples proyectos para diferentes bases de código.
La diferencia importante frente a otras herramientas: un solo Proyecto puede tener múltiples carpetas. Si tu aplicación tiene un frontend en React y un backend en Python en repositorios separados, puedes añadir los dos al mismo Proyecto y el agente tiene contexto completo de los dos.
Paso 1: Crear un Proyecto
- En la barra lateral izquierda, haz clic en el ícono de carpeta con "+".
- Selecciona "New Project".
- Haz clic en "Add Folder" y selecciona la carpeta de tu proyecto (o repositorio Git).
- Repite para cada carpeta adicional que necesites.
- Haz clic en "Create".
Opcionalmente, ajusta los settings del Proyecto: nivel de permisos de terminal (pedir permiso vs. proceder automáticamente), acceso a archivos fuera de la carpeta, y el preset de seguridad (Default, Full Machine, o Unrestricted).
Paso 2: Lanzar un agente
Con el Proyecto abierto, escribe tu instrucción en el campo de chat. Antigravity te pide elegir el modo de trabajo antes de iniciar:
- Local Mode: el agente trabaja directamente en tus carpetas activas. Bueno para tareas rápidas e iterativas donde quieres ver los cambios de inmediato.
- New Worktree Mode: crea una rama Git aislada para esa conversación. El agente trabaja en esa rama sin tocar tu código activo. Ideal para tareas complejas o cuando corres varios agentes en paralelo.
Paso 3: Entender los modos de planificación
Cuando el agente recibe tu instrucción, trabaja en uno de dos modos:
- Planning Mode (recomendado): el agente primero investiga el código, luego genera un Plan de Implementación — un artifact con los cambios propuestos — y espera tu aprobación antes de tocar cualquier archivo. Es el modo por defecto y el más seguro.
- Fast Mode: el agente ejecuta directamente sin una fase de planificación. Útil para tareas simples como renombrar una variable o correr un comando puntual.
Paso 4: Revisar el Plan de Implementación (Artifact)
En Planning Mode, el agente para y te muestra un Plan de Implementación antes de hacer cualquier cambio. Ese plan incluye:
- Qué archivos va a modificar y por qué
- Los cambios específicos que propone en cada archivo
- Cualquier dependencia o comando que necesite ejecutar
Puedes hacer tres cosas con el plan:
- Proceed: apruebas el plan y el agente empieza a ejecutar.
- Comentar: haces clic en cualquier parte del plan y dejas un comentario con lo que quieres cambiar. El agente revisa y genera un nuevo plan.
- Review: abres un panel de todos los comentarios y envías un mensaje general de feedback.
Paso 5: Revisar los cambios de código
Una vez que el agente ejecuta el plan, puedes ver todos los cambios en la sección "Review Changes" del panel del agente. Es un diff visual de todos los archivos modificados en la conversación. También puedes comentar directamente sobre los diffs.
Cuando el agente termina una tarea compleja, genera un Walkthrough: un resumen de todos los cambios que hizo, con screenshots si trabajó en el navegador.
Los comandos slash más útiles
Tanto en Antigravity 2.0 como en la CLI, puedes usar comandos slash:
/goal— el agente ejecuta la tarea completa hasta terminar, sin pedirte confirmación en pasos intermedios./grill-me— antes de empezar, el agente te hace preguntas para clarificar exactamente qué quieres. Muy útil para tareas ambiguas./browser— activa el subagente de navegador para tareas de Chrome (scraping, testing de UI, interacción con dashboards)./schedule— programa una tarea para que el agente la ejecute en un horario específico o de forma recurrente./teamwork-preview— (solo plan Ultra) lanza un equipo de múltiples agentes colaborando para tareas muy complejas.
Atajos de teclado esenciales (CLI y app)
Esc— interrumpe la acción actual del agente sin cerrar la sesión.Ctrl+R— abre el panel de revisión de artifacts.Ctrl+K— aprueba la acción pendiente de un subagente sin cambiar de pantalla.Alt+J(oCtrl+J) — va directo al subagente que está esperando tu aprobación.Shift+Enter— insertar una línea nueva en el prompt sin enviarlo.
Buenas prácticas para dummies
Para sacar el máximo provecho de Antigravity desde el primer día:
- Empieza con /grill-me para tareas complejas. El agente te hace preguntas de clarificación y el resultado es mucho más preciso.
- Usa Planning Mode siempre. El plan de implementación es tu oportunidad de corregir el rumbo antes de que el agente toque el código.
- Crea un GEMINI.md o AGENTS.md en tu proyecto. El agente lo lee al inicio de cada sesión. Escribe ahí las convenciones de tu proyecto para no repetirlas cada vez.
- Usa New Worktree para tareas grandes. El agente trabaja en una rama aislada y tú decides si mergeas cuando estés satisfecho.
- Pide verificación explícita. Al final de tu instrucción, agrega "y corre los tests para verificar" — el agente ejecutará la suite de pruebas y corregirá si algo falla.
En resumen
El flujo básico de Antigravity es: crear proyecto → lanzar agente → revisar plan → aprobar → revisar cambios. El sistema está diseñado para que tengas control en cada paso sin tener que supervisar cada línea de código.
El siguiente nivel es extender las capacidades del agente con Skills y MCP servers. Lee cómo usar Skills y MCP en Google Antigravity para conectar el agente con tus herramientas.