Cómo usar Google Antigravity 2.0 paso a paso
Aprende cómo usar Google Antigravity desde la aplicación Antigravity 2.0: crea un Project, añade carpetas, inicia un agente, elige entre Local Mode y New Worktree, entrega una tarea clara, revisa el plan, controla los permisos y verifica los cambios antes de aceptarlos.
¿Cómo se usa Google Antigravity?
Abre Antigravity 2.0, crea un Project y añade la carpeta o los repositorios que necesita el agente. Después inicia una conversación, describe el resultado que buscas y elige cómo trabajará: directamente sobre tus carpetas con Local Mode o dentro de un Git worktree aislado con New Worktree Mode.
Crea un Project
Define las carpetas, el contexto y los límites de acceso.
Inicia una conversación
Usa un hilo diferente para cada objetivo importante.
Selecciona el modo
Local para cambios directos; Worktree para aislar una tarea Git.
Describe el objetivo
Incluye contexto, restricciones, pruebas y resultado esperado.
Revisa el plan
Corrige alcance o enfoque antes de permitir modificaciones.
Supervisa permisos
Aprueba solo archivos, comandos, URLs y herramientas necesarias.
Verifica el resultado
Comprueba artifacts, tests, build y diff antes de finalizar.
El punto clave es no limitarse a esperar una respuesta textual. Antigravity está diseñado para ejecutar trabajo sobre proyectos reales; por eso debes revisar tanto el razonamiento de alto nivel como la evidencia producida.
Esta guía explica Antigravity 2.0, no Antigravity CLI
Antigravity 2.0 es la aplicación independiente que funciona como centro de comando para agentes. La CLI es otra superficie del mismo ecosistema y se utiliza desde la terminal con agy. Elegir la guía correcta evita mezclar botones de la app con comandos de consola.
| Necesidad | Superficie adecuada | Guía |
|---|---|---|
| Gestionar proyectos y varios agentes visualmente | Antigravity 2.0 | Continúa en esta página. |
| Trabajar con agentes desde una terminal | Antigravity CLI | Abrir guía de la CLI |
| Descargar agy y configurar el PATH | Instalador de la CLI | Ver instalación |
| Entender todo el ecosistema de Google | Hub Antigravity | Ver guía principal |
Necesitas la aplicación Antigravity 2.0 y una carpeta de prueba
Descarga la aplicación desde Google, inicia sesión y prepara un proyecto que puedas modificar sin riesgo. Para la primera sesión conviene utilizar un repositorio propio, con Git y sin cambios pendientes.
Cómo se organiza la interfaz de Antigravity 2.0
La aplicación separa la organización del trabajo de la conversación individual. Un Project agrupa carpetas, ajustes, permisos e historial; dentro de él puedes abrir conversaciones y ejecutar agentes para objetivos distintos.
Esta estructura permite cambiar de una conversación a otra sin mezclar todos los objetivos en un único hilo. También facilita asignar permisos diferentes a proyectos con riesgos distintos.
Cómo crear tu primer Project en Antigravity
Un Project define las carpetas que forman el entorno del agente. Puede contener un único directorio, varios repositorios Git o una combinación de repositorios y carpetas locales.
Abre el selector de proyectos
En la barra lateral izquierda, pulsa el icono de carpeta con el signo más.
Selecciona New Project
Crea un proyecto independiente para que sus conversaciones y ajustes no se confundan con otro cliente o repositorio.
Añade una o varias carpetas
Usa Add Folder para seleccionar los directorios o checkouts Git que el agente necesita. No añadas toda tu carpeta de usuario.
Revisa el alcance
Confirma que cada carpeta pertenece al mismo producto o workflow y que no contiene secretos innecesarios.
Pulsa Create
Antigravity guardará la combinación de carpetas como un Project reutilizable.
Configura sus ajustes
Revisa el preset de permisos y las reglas específicas del Project antes de iniciar el primer agente.
Cuándo conviene añadir varias carpetas
Utiliza un Project multi-folder cuando una misma tarea requiere contexto cruzado: por ejemplo, un repositorio frontend y otro backend, o una aplicación junto a su documentación. Si las carpetas no guardan relación, crea Projects diferentes para reducir contexto y permisos.
Añade el contexto necesario, no todo el equipo
Las carpetas del Project delimitan el entorno de trabajo. Una raíz demasiado amplia puede exponer código, documentos o credenciales que no aportan nada a la tarea.
Cómo iniciar y completar una tarea con un agente
Comprueba el estado del proyecto
Revisa Git, pruebas conocidas y archivos pendientes. Un punto de partida limpio facilita atribuir cada modificación.
Crea una conversación
Abre un hilo nuevo para el objetivo. En macOS puedes usar Cmd+N; en Windows o Linux, Ctrl+N.
Escribe el objetivo
Describe el comportamiento esperado, las restricciones y la forma de verificarlo. Presiona Enter para continuar.
Elige Local o New Worktree
Selecciona cambios directos para trabajo interactivo pequeño o un worktree cuando quieras aislamiento Git.
Deja que investigue
El agente leerá archivos, buscará patrones y puede formular preguntas. Responde las decisiones de producto que no pueda inferir.
Revisa el Implementation Plan
Comprueba archivos, alcance, enfoque técnico, riesgos y pruebas. Comenta el artifact si el plan no coincide con tu intención.
Autoriza las acciones necesarias
Revisa solicitudes para comandos, archivos, URLs, navegador o MCP. Rechaza cualquier acceso que no corresponda al objetivo.
Supervisa la implementación
Observa los hitos y corrige pronto si el agente amplía el alcance o adopta un patrón que el proyecto no utiliza.
Exige verificación
Pide tests, lint, typecheck, build o comprobación en navegador, según el tipo de cambio.
Revisa artifacts y diff
Confirma qué se cambió, qué se probó y qué quedó sin verificar antes de integrar o cerrar la conversación.
Local Mode vs New Worktree Mode: cuál elegir
El selector de modo determina dónde escribirá el agente. La elección no depende de cuál sea “mejor”, sino del tamaño, riesgo y necesidad de aislamiento de la tarea.
| Criterio | Local Mode | New Worktree Mode |
|---|---|---|
| Ubicación | Trabaja en tus carpetas y checkouts activos. | Provisiona un Git worktree aislado para la conversación. |
| Mejor para | Cambios rápidos y revisión interactiva inmediata. | Features complejas, experimentos y trabajo concurrente. |
| Carpeta actual | Puede modificarse directamente. | Permanece separada de los cambios del agente. |
| Paralelismo | Varios agentes pueden coincidir sobre los mismos archivos. | Cada sesión puede trabajar en un entorno Git separado. |
| Riesgo de conflicto | Mayor si existen cambios humanos o agentes simultáneos. | Menor durante la implementación aislada. |
| Requisito Git | No necesita que la carpeta sea un repositorio. | El aislamiento se aplica a los checkouts Git del Project. |
Usa Local Mode cuando
Quieres una corrección pequeña, estás observando el diff en tiempo real y nadie más modifica los mismos archivos. Antes de comenzar, confirma que no existan cambios sin guardar o commits ajenos a la tarea.
Usa New Worktree Mode cuando
La tarea puede afectar varios archivos, quieres comparar una solución o planeas ejecutar agentes en paralelo. El worktree protege el checkout activo, pero no elimina la revisión: el resultado todavía debe probarse e integrarse conscientemente.
Cómo pedir una tarea sin dejar decisiones importantes al azar
Una instrucción eficaz define el resultado y la evidencia. No es necesario contarle al agente cada detalle del código; sí conviene fijar el alcance, las restricciones y qué significa “terminado”.
Objetivo:
Corrige el error que impide guardar el perfil cuando el teléfono está vacío.
Antes de editar:
1. reproduce o localiza la causa
2. revisa validadores y tests existentes
3. crea un plan breve
Restricciones:
- no cambies la respuesta pública de la API
- no añadas dependencias
- evita refactors no relacionados
Verificación:
- añade un test de regresión
- ejecuta los tests relevantes
- ejecuta lint o typecheck si están disponibles
- revisa el diff completo
Entrega final:
- causa raíz
- archivos modificados
- pruebas ejecutadas y resultado
- cualquier aspecto no verificadoPara requisitos ambiguos, usa /grill-me
La documentación actual incluye /grill-me para pedir al agente que formule preguntas antes de implementar. Resulta útil cuando faltan decisiones sobre interfaz, compatibilidad o criterios de aceptación.
No conviertas cada tarea en un megaproceso
Un error pequeño puede resolverse con una conversación corta. Reserva planes extensos, subagentes y varias verificaciones para cambios cuyo alcance realmente lo justifique. Dividir una feature grande en hitos revisables suele ser más fiable que una orden abierta para “mejorar todo”.
Cómo revisar planes, artifacts y resultados
Los artifacts son entregables estructurados creados para comunicar progreso y permitir revisión en hitos. Antigravity 2.0 puede mostrar planes de implementación, diffs, diagramas, imágenes y grabaciones de navegador desde una interfaz visual.
| Artifact | Qué debes comprobar |
|---|---|
| Implementation Plan | Alcance, archivos, dependencias, riesgos y método de prueba. |
| Diff de código | Cambios inesperados, lógica, errores, secretos y compatibilidad. |
| Diagrama | Que represente la arquitectura real y no una suposición. |
| Captura | Estado correcto, viewport, datos de prueba y ausencia de errores visibles. |
| Browser recording | Que el recorrido complete el flujo y no omita interacciones críticas. |
| Walkthrough | Resumen de lo realizado, archivos cambiados y evidencia de verificación. |
Comenta el plan antes de pulsar Proceed
Si el Implementation Plan utiliza otra tecnología, amplía el alcance o ignora un requisito, añade feedback directamente al artifact. El agente puede iterar sobre el plan y solicitar otra revisión antes de escribir archivos. Corregir aquí es más barato que revertir una implementación.
No cierres la tarea con un resumen como única prueba
Busca tres tipos de evidencia: cambio —diff—, ejecución —tests o build— y comportamiento —reproducción manual, captura o navegador—. Un resumen del agente no reemplaza ninguna de ellas.
Cómo configurar permisos en Google Antigravity
El motor de permisos evalúa acciones sensibles mediante listas Deny, Ask y Allow. Puede controlar lectura y escritura de archivos, comandos, carga o interacción con URLs y llamadas a herramientas MCP.
| Preset | Comportamiento general | Cuándo elegirlo |
|---|---|---|
| Default | Usa sandbox; permite comandos aislados y pide aprobación al salir de sus límites. | Primera opción para la mayoría de proyectos. |
| Request Review | Pide confirmación para comandos y mantiene acceso limitado al workspace. | Repositorios sensibles o aprendizaje supervisado. |
| Turbo | Entrega acceso mucho más amplio y reduce solicitudes de aprobación. | Solo en entornos aislados y desechables que puedas reconstruir. |
En macOS y Linux, el preset Default utiliza el Terminal Sandbox. La documentación oficial indica que Windows continúa temporalmente con el sistema anterior, por lo que la interfaz y algunas solicitudes pueden variar según el sistema operativo.
Configura por Project
Los Projects heredan la configuración general, pero pueden añadir permisos específicos. Utiliza esa separación: un repositorio de prueba no necesita la misma política que un proyecto con datos sensibles. Una regla explícita Ask o Deny tiene prioridad sobre Allow cuando coinciden.
Qué revisar en una tarjeta de permiso
Acción
¿Quiere leer, escribir, ejecutar, navegar o llamar una herramienta?
Destino
Comprueba la ruta, dominio, comando o servidor MCP exacto.
Alcance
Evita ampliar una autorización de un archivo a todo el sistema.
Necesidad
Pregunta si esa acción es indispensable para completar el objetivo.
Consecuencia
Considera datos, red, producción, credenciales y reversibilidad.
Cómo trabajar con varias conversaciones y agentes
Antigravity 2.0 puede ejecutar y supervisar agentes de forma síncrona o asíncrona. La ventaja no consiste en abrir muchos por defecto, sino en separar tareas independientes y ofrecer a cada una un entorno claro.
| Situación | Organización recomendada |
|---|---|
| Una corrección pequeña | Una conversación y un agente en Local Mode. |
| Feature con investigación previa | Una conversación principal; delegación solo si aporta separación real. |
| Dos features independientes | Conversaciones distintas, preferiblemente con worktrees separados. |
| Frontend y backend relacionados | Project multi-folder y objetivos delimitados por conversación. |
| Dos soluciones alternativas | Entornos aislados para comparar antes de integrar. |
| Trabajo sobre los mismos archivos | Evita agentes simultáneos en Local Mode para reducir conflictos. |
Una conversación por resultado
No reutilices indefinidamente el mismo hilo para bugs, features y documentación sin relación. Un contexto más pequeño facilita encontrar decisiones, revisar artifacts y reanudar una tarea sin instrucciones antiguas compitiendo con el objetivo actual.
Atajos y slash commands de Antigravity 2.0
| Acción | macOS | Windows / Linux |
|---|---|---|
| Abrir conversaciones | Cmd+K | Ctrl+K |
| Buscar archivos | Cmd+P | Ctrl+P |
| Enfocar entrada | Cmd+L | Ctrl+L |
| Nueva conversación | Cmd+N | Ctrl+N |
| Conversación anterior o siguiente | Option+↑ / ↓ | Alt+↑ / ↓ |
| Comando | Uso | Precaución |
|---|---|---|
| /grill-me | Pide preguntas aclaratorias antes de implementar. | Responde decisiones concretas, no supuestos vagos. |
| /goal | Indica que continúe hasta completar el objetivo. | Define límites y verificación antes de aumentar autonomía. |
| /browser | Controla comportamientos de depuración en Chrome. | Autoriza solo los dominios y acciones necesarios. |
| /schedule | Programa una instrucción única o recurrente. | Revisa que el entorno y permisos sigan siendo válidos. |
Los comandos disponibles pueden evolucionar. Escribe una barra en la entrada o consulta la ayuda integrada para confirmar qué opciones admite tu versión de la aplicación.
Ejemplo: usar Antigravity para corregir un bug
Supongamos que una aplicación muestra un error al enviar un formulario. Este workflow mantiene el alcance pequeño y la evidencia visible.
Prepara el Project
Añade el repositorio y confirma que Git no tenga cambios ajenos.
Abre una conversación nueva
Utiliza un nombre reconocible, como “Bug formulario de perfil”.
Elige New Worktree
Aísla la corrección si el repositorio está activo o la tarea puede crecer.
Entrega reproducción y límites
Indica pasos, error, resultado esperado y componentes que no deben cambiar.
Revisa la causa y el plan
No procedas si el agente aún no distingue síntoma de causa raíz.
Implementa con test de regresión
Autoriza los archivos y comandos específicos del cambio.
Verifica comportamiento
Ejecuta tests y reproduce el formulario en navegador si corresponde.
Integra conscientemente
Revisa el diff del worktree y lleva solo la solución aprobada a tu rama.
Errores frecuentes al empezar con Google Antigravity
| Problema | Causa probable | Qué revisar |
|---|---|---|
| El agente no ve un archivo | La carpeta no forma parte del Project. | Añade solo la carpeta necesaria y reinicia el contexto de la tarea. |
| Editó mi checkout activo | La conversación se inició en Local Mode. | Revisa Git y utiliza New Worktree en la próxima tarea aislada. |
| El plan es demasiado amplio | El objetivo no limitó alcance ni refactors. | Comenta el artifact y exige un plan más pequeño antes de Proceed. |
| Solicita permisos repetidamente | Las acciones no están cubiertas por reglas específicas. | Ajusta el alcance del Project; evita activar Turbo como solución general. |
| Un comando necesita internet | El sandbox no tiene acceso al dominio. | Comprueba el dominio y concede una regla read_url acotada si es seguro. |
| Dos agentes generan conflictos | Trabajan sobre las mismas carpetas en Local Mode. | Separa tareas y utiliza worktrees independientes. |
| La conversación perdió foco | El hilo mezcla demasiados objetivos. | Crea una conversación nueva con un resultado y contexto explícitos. |
| El resumen dice que funciona | No se ejecutó una verificación suficiente. | Exige salida de tests, build, diff y prueba del comportamiento. |
Lista de control para usar Antigravity de forma segura
Project correcto
Solo contiene las carpetas relacionadas con el trabajo.
Estado recuperable
Git está limpio o los cambios previos están identificados.
Modo adecuado
Elegiste Local o Worktree según el riesgo y paralelismo.
Objetivo medible
La tarea incluye restricciones y criterios de aceptación.
Plan revisado
Entiendes archivos, enfoque, riesgos y pruebas propuestas.
Permisos mínimos
Cada acceso corresponde a una necesidad concreta.
Evidencia revisada
Comprobaste artifacts, comandos, pruebas y comportamiento.
Diff final limpio
No quedaron archivos o cambios ajenos al objetivo.
Fuentes oficiales para aprender a usar Antigravity
El flujo, los modos, los atajos y los permisos de esta guía fueron contrastados con la documentación oficial de Google. Si una opción cambia en una versión futura, considera estas páginas como referencia principal.
Siguiente guía: Google Antigravity precio y planes
FAQ sobre cómo usar Google Antigravity
Crea un Project, añade las carpetas necesarias, abre una conversación, describe el objetivo y elige Local Mode o New Worktree Mode. Después revisa el plan, los permisos, los artifacts, las pruebas y el diff final.
Es una configuración que agrupa una o varias carpetas, ajustes aislados, permisos e historial de conversaciones. Define el contexto y los límites de trabajo de los agentes.
Local Mode trabaja directamente en las carpetas activas. New Worktree Mode crea un Git worktree aislado para la conversación, protegiendo el checkout activo y reduciendo conflictos entre tareas.
Sí. Un Project puede incluir varias carpetas o repositorios, como un frontend y un backend. Conviene añadir solo el contexto relacionado para no ampliar permisos y búsqueda innecesariamente.
Sí. Los agentes pueden leer y escribir archivos, ejecutar comandos, navegar y utilizar herramientas. Estas acciones dependen del preset, las reglas del Project y las aprobaciones que concedas.
Revisa el Implementation Plan, los artifacts, el diff y la salida de tests o build. Para cambios visibles, comprueba también el comportamiento con capturas, grabaciones o una prueba manual.
Puedes iniciar tareas sin escribir código manualmente, pero entender el proyecto, evaluar riesgos y validar resultados sigue siendo importante. Cuanto más sensible sea el cambio, mayor debe ser la supervisión técnica.
No. Antigravity 2.0 es una aplicación de escritorio para organizar y supervisar agentes y Projects. Antigravity CLI se usa desde la terminal mediante el comando agy.
Crea un Project pequeño y completa una tarea verificable
Empieza con un repositorio propio, permisos conservadores y un objetivo que puedas probar. El mejor primer resultado no es el más grande: es aquel cuyo plan, cambios y comportamiento puedes explicar y verificar.
Descargar Antigravity 2.0 →