Antigravity CLI: qué es, cómo funciona y comandos de agy
Antigravity CLI es la interfaz de terminal de Google Antigravity. Se inicia con el comando agy y permite pedir a un agente que explore repositorios, edite archivos, ejecute pruebas, revise diffs, utilice subagentes y conecte Skills o servidores MCP sin abandonar la consola. Esta guía explica sus funciones, comandos y flujo de trabajo; la instalación se encuentra en un tutorial independiente.
¿Qué es Antigravity CLI?
Antigravity CLI es una herramienta de programación agentic que funciona dentro de la terminal. Al ejecutar agy desde la carpeta de un proyecto, se abre una interfaz de texto —TUI— desde la que puedes conversar con un agente capaz de leer código, proponer un plan, crear o modificar archivos y ejecutar comandos con permisos controlados.
cd ruta-del-proyecto
agyEl flujo recomendado es: abrir un repositorio, describir el objetivo, pedir al agente que investigue, revisar su plan, aprobar solo las acciones necesarias, ejecutar tests y comprobar el diff final. Antigravity CLI no es solo un chatbot: trabaja sobre el sistema local mediante herramientas y mantiene una conversación asociada al proyecto.
La instalación tiene su propia guía paso a paso
Consulta los comandos oficiales para Windows, macOS y Linux, la autenticación y las soluciones para problemas con el PATH.
Antigravity CLI, Antigravity 2.0 e IDE no son lo mismo
Google ofrece varias superficies conectadas al ecosistema Antigravity. La CLI está pensada para quien prefiere dirigir agentes desde una consola o integrar instrucciones en scripts. La aplicación Antigravity 2.0 organiza proyectos y agentes desde un centro de comando visual, mientras que las opciones para IDE acercan el agente al editor de código.
| Superficie | Cómo se abre | Uso principal |
|---|---|---|
| Antigravity CLI | Comando agy en la terminal | Trabajar con agentes, comandos y archivos desde una TUI. |
| Antigravity 2.0 | Aplicación de escritorio independiente | Crear Projects y supervisar varios agentes o conversaciones. |
| Antigravity IDE | Entorno de desarrollo visual | Editar código y revisar cambios con paneles integrados. |
| Extensiones para IDE | VS Code, JetBrains y otros editores compatibles | Usar capacidades de Antigravity dentro del editor habitual. |
Aquí aprenderás la herramienta de terminal, no a instalarla
Esta guía responde qué puede hacer Antigravity CLI y cómo trabajar con ella. Para descargarla, iniciar sesión o corregir el comando agy, utiliza la guía de instalación. Para entender todo el producto, visita el hub de Google Antigravity.
Qué puede hacer Antigravity CLI en un proyecto
La CLI combina conversación, acceso al workspace y herramientas de ejecución. Su utilidad aparece cuando el agente puede observar el repositorio, actuar sobre él y presentar evidencia verificable del resultado.
Tener estas capacidades no significa que todas las acciones se ejecuten automáticamente. Las escrituras, los comandos, el acceso web y MCP se evalúan mediante el sistema de permisos configurado para la sesión.
Cómo funciona Antigravity CLI paso a paso
Abre la carpeta correcta
Entra desde la terminal al repositorio que quieres analizar. La ubicación desde la que inicias agy define el workspace principal y ayuda a limitar el contexto de la tarea.
Inicia la interfaz con agy
Ejecuta agy. La TUI abre el campo de conversación, el estado de la sesión y los controles para revisar solicitudes.
Describe un resultado concreto
Explica qué debe cambiar, qué restricciones existen y cómo debe comprobarse. Para tareas complejas, pide primero exploración y un plan sin modificar archivos.
Observa la investigación
El agente consulta archivos y puede proponer herramientas. Detén el turno con Esc si interpreta mal el objetivo o investiga una zona que no corresponde.
Revisa el plan y los permisos
Comprueba el alcance, las rutas y los comandos solicitados. Acepta únicamente las acciones que entiendas y rechaza las que excedan la tarea.
Deja que implemente
Con el plan aprobado, el agente edita archivos y puede ejecutar verificaciones. La interfaz informa el progreso y las acciones que necesitan intervención.
Abre artifacts y diffs
Utiliza Ctrl+R, /artifact o /diff para inspeccionar los entregables y cambios antes de darlos por correctos.
Verifica y cierra
Pide tests, lint o build, revisa Git y solicita un resumen final. Termina la TUI con /exit o Ctrl+D cuando el campo de entrada esté vacío.
cd mi-proyecto
git status
agyEmpieza desde un estado Git conocido
Revisa git status y crea un commit si corresponde. Así podrás distinguir el trabajo del agente de cambios previos y recuperar el punto de partida si la solución no sirve.
Comandos principales de Antigravity CLI
Escribe / en el campo de entrada para abrir el selector de comandos disponible en tu versión. La tabla reúne los controles que resultan más útiles durante un flujo normal; la referencia oficial puede incorporar nuevas opciones con el tiempo.
| Comando | Para qué sirve | Cuándo usarlo |
|---|---|---|
| /help | Abre la ayuda de comandos y atajos. | Cuando necesitas consultar controles disponibles. |
| /config | Abre la configuración; /settings funciona como alias. | Para ajustar permisos, aspecto y comportamiento. |
| /permissions | Muestra el gestor de permisos de herramientas. | Antes de aumentar o reducir la autonomía. |
| /artifact | Abre el panel de revisión de artifacts. | Para aprobar o rechazar planes y archivos generados. |
| /diff | Abre el visor interactivo de cambios. | Para auditar modificaciones por turno, archivo o commit. |
| /resume | Lista conversaciones anteriores; /switch es alias. | Para continuar una sesión guardada. |
| /rewind | Retrocede el hilo a un punto anterior; /undo es alias. | Para corregir una dirección equivocada. |
| /fork | Crea una rama paralela de la conversación. | Para probar otra solución sin perder la sesión estable. |
| /agents | Abre el panel de agentes y subagentes. | Para supervisar tareas paralelas y aprobaciones. |
| /tasks | Gestiona procesos y tareas en segundo plano. | Para ver registros o detener ejecuciones activas. |
| /skills | Lista Skills locales y globales cargadas. | Para descubrir workflows reutilizables. |
| /mcp | Abre el gestor de servidores MCP. | Para conectar herramientas o fuentes externas. |
| /model | Permite seleccionar el modelo disponible. | Cuando tu plan ofrece más de una opción. |
| /usage | Muestra el uso o cuota de modelos; /quota es alias. | Para revisar consumo antes de una tarea extensa. |
| /exit | Cierra la TUI; /quit funciona como alias. | Cuando terminaste o quieres volver al shell. |
Atajos que conviene memorizar
| Atajo | Acción |
|---|---|
| Enter | Envía la instrucción o confirma la opción seleccionada. |
| Shift+Enter o Ctrl+J | Inserta una nueva línea sin enviar el prompt. |
| Esc | Interrumpe el stream, cierra un panel o cancela una acción. |
| Ctrl+R | Abre el panel de revisión de artifacts. |
| Ctrl+V | Pega texto o adjunta medios compatibles desde el portapapeles. |
| Ctrl+G | Abre el editor externo configurado para redactar un prompt largo. |
| Y / N | Aprueba o rechaza una herramienta, comando o artifact pendiente. |
| Ctrl+D | Sale de la CLI cuando el campo de entrada está vacío. |
Los atajos son personalizables mediante /keybindings. Si una combinación no coincide con la tabla, revisa la configuración de tu versión y el archivo local de keybindings.
Cómo escribir una buena tarea para agy
Una orden útil no necesita ser extensa, pero sí debe eliminar ambigüedades. Incluye cinco piezas: resultado esperado, contexto, límites, verificación y formato de entrega.
Objetivo:
Corrige el error de validación al guardar el formulario de registro.
Antes de editar:
- revisa el flujo actual
- identifica la causa raíz
- enumera los archivos que cambiarías
Restricciones:
- no cambies la API pública
- evita refactors no relacionados
- conserva los mensajes existentes
Verificación:
- ejecuta los tests relevantes
- añade un test de regresión
- revisa el diff completo
Al terminar:
resume archivos modificados, pruebas ejecutadas y cualquier riesgo pendiente.Añade archivos con @
Escribe @ en el prompt para activar sugerencias de rutas del workspace. Seleccionar un archivo reduce la búsqueda y deja explícito qué código debe examinar el agente. Para un problema visual, puedes pegar una captura compatible con Ctrl+V y explicar qué resultado esperabas.
Separa investigación e implementación
En cambios delicados, comienza con “analiza y crea un plan; no edites todavía”. Revisa la propuesta y solo después pide la implementación. Este patrón evita que una suposición temprana se convierta en cambios innecesarios por todo el repositorio.
No copies todo el repositorio dentro del mensaje
Antigravity CLI puede inspeccionar el workspace. Señala rutas, comportamiento, restricciones y criterios de aceptación; deja que el agente busque el contexto técnico relevante y pregunte si falta una decisión de producto.
Cómo revisar artifacts, archivos y diffs
Un artifact es un entregable estructurado que permite entender lo que el agente propone o produjo. Puede ser un plan de implementación, un archivo de código, un diff, un diagrama o un recurso visual. La CLI los reúne en un panel de revisión para aprobar, rechazar o comentar antes de continuar, según la política activa.
Abre el panel
Presiona Ctrl+R o escribe /artifact cuando aparezca una revisión pendiente.
Revisa uno por uno
Navega con las flechas, abre cada archivo y compara el contenido o diff completo.
Aprueba o rechaza
Usa Y para aceptar y N para rechazar. Evita aprobar todo sin inspección.
Entrega feedback
Señala líneas o decisiones que deban corregirse y devuelve la revisión al agente.
Comprueba el diff final
Abre /diff y confirma que no existan ediciones ajenas al objetivo.
La revisión no sustituye las pruebas. Un diff razonable puede contener un error de comportamiento, y un test exitoso puede no cubrir todos los archivos cambiados. Combina ambos controles antes de aceptar el trabajo.
Permisos y sandbox de Antigravity CLI
Antigravity evalúa operaciones sensibles mediante reglas de Deny, Ask y Allow. Las reglas pueden cubrir lectura o escritura de archivos, comandos, URLs y herramientas MCP. Si existen reglas en conflicto, la política oficial aplica la prioridad Deny, luego Ask y finalmente Allow.
| Nivel | Comportamiento | Uso recomendado |
|---|---|---|
| request-review | Solicita revisión para escrituras, comandos o acceso remoto según la acción. | Punto de partida equilibrado para aprender la herramienta. |
| proceed-in-sandbox | Permite avanzar dentro del aislamiento y pide revisión cuando es necesario salir. | Workflows repetibles con comandos compatibles con el sandbox. |
| strict | Pide confirmación para todas las operaciones que no sean de lectura. | Repositorios sensibles o sesiones de auditoría. |
| always-proceed | Reduce las pausas de aprobación y entrega mayor autonomía. | Solo en entornos desechables y controlados; no como primera configuración. |
Qué protege el terminal sandbox
El sandbox limita el acceso a rutas del sistema y conexiones de red cuando el agente ejecuta comandos. Una tarea que necesite recursos fuera de esos límites puede detenerse y pedir autorización. Lee el comando y su destino antes de permitir una ejecución sin aislamiento.
Reglas granulares
Los usuarios avanzados pueden definir reglas específicas en ~/.gemini/antigravity-cli/settings.json. Es preferible autorizar un comando o ruta concreta que utilizar comodines globales. Conserva bloqueadas las credenciales, claves SSH, historiales Git y cualquier directorio ajeno al workspace que el agente no necesite.
El permiso debe corresponder al alcance de la tarea
Si el objetivo es corregir un componente, no necesita escritura en todo el sistema. Si solo debe investigar, comienza con lectura. Y si una acción afecta producción, credenciales o datos reales, detén el flujo y revísala fuera de la sesión autónoma.
Conversaciones, tareas y subagentes en la CLI
Cada conversación conserva el hilo de una tarea. Al cerrar la CLI, la herramienta puede mostrar el comando necesario para reanudar la sesión. También puedes abrir /resume, cambiar el nombre con /rename, volver atrás con /rewind o crear un experimento separado mediante /fork.
Cuándo usar subagentes
Los subagentes son sesiones independientes que trabajan en segundo plano. Resultan útiles cuando existe trabajo realmente divisible: por ejemplo, un agente investiga la arquitectura mientras otro ejecuta una batería de pruebas. No aportan ventaja automática en una corrección de un solo archivo y pueden aumentar el consumo o la coordinación.
| Situación | Mejor enfoque |
|---|---|
| Cambio pequeño y localizado | Un agente principal con revisión directa. |
| Investigación en varios módulos | Subagentes de lectura con resultados separados. |
| Implementación más verificación | Agente principal para cambios y subagente para tests. |
| Dos enfoques alternativos | /fork para comparar sin mezclar el hilo estable. |
| Comando largo en segundo plano | /tasks para observar registros o detenerlo. |
El panel /agents muestra agentes activos, finalizados o detenidos y permite gestionar solicitudes pendientes. Cada subagente recibe herramientas y permisos definidos por el agente principal; una tarea delegada no elimina la necesidad de revisar sus acciones.
Skills, MCP y plugins en Antigravity CLI
| Componente | Qué aporta | Ejemplo |
|---|---|---|
| Skills | Instrucciones, scripts y referencias reutilizables para una tarea. | Aplicar siempre el mismo proceso de revisión o despliegue. |
| MCP | Conecta herramientas y fuentes externas mediante Model Context Protocol. | Consultar documentación, datos o servicios autorizados. |
| Hooks | Ejecutan controles asociados a eventos del workflow. | Aplicar formato o validaciones después de un cambio. |
| Custom Agents | Definen agentes especializados con instrucciones y herramientas. | Separar investigación de seguridad y ejecución de pruebas. |
| Plugins | Empaquetan Skills, agentes, reglas, MCP y hooks en un módulo. | Distribuir una configuración coherente para un equipo. |
Abre /skills para ver Skills cargadas y /mcp para administrar servidores MCP. Instala solo extensiones cuyo origen, permisos y comandos entiendas: un paquete puede ampliar significativamente las herramientas disponibles para el agente.
Cómo usar agy sin abrir la interfaz interactiva
La opción -p permite enviar una instrucción de una sola vez. Es útil para análisis acotados, scripts o pipelines donde no quieres abrir la TUI completa.
agy -p "Revisa este diff y redacta un mensaje de commit convencional" --cwd "$(pwd)"Un flujo no interactivo debe tener límites especialmente claros. Define el directorio, solicita una salida concreta y evita conceder permisos de escritura o red que el proceso no necesite. No automatices aprobaciones destructivas únicamente para impedir que un pipeline se detenga.
Comandos directos dentro de la TUI
Cuando estás en una sesión interactiva, anteponer ! a una instrucción permite ejecutar un comando de terminal directamente, sujeto a la configuración aplicable. Utilízalo para acciones que ya conoces, como consultar el estado del repositorio, no para eludir la revisión de comandos propuestos por el agente.
Mejores prácticas para trabajar con Antigravity CLI
Entrega una forma de verificar
Indica el comando de test, lint, typecheck o build que debe superar.
Explora, planifica y luego ejecuta
Separa la investigación de la edición en tareas complejas.
Define reglas del repositorio
Documenta convenciones y pruebas en AGENTS.md o GEMINI.md en la raíz.
Limita el alcance
Pide que evite refactors, dependencias o cambios públicos no relacionados.
Interrumpe temprano
Usa Esc al detectar una interpretación incorrecta; corregir pronto cuesta menos.
Revisa la evidencia
Comprueba artifacts, resultados de pruebas y diff, no solo el resumen del agente.
Mantén permisos mínimos
Autoriza únicamente las rutas, comandos y servicios necesarios para el objetivo.
Conserva una salida recuperable
Trabaja con Git, copias o entornos descartables antes de cambios amplios.
Problemas frecuentes al usar Antigravity CLI
| Problema | Causa habitual | Qué hacer |
|---|---|---|
| agy no se reconoce | La CLI no está instalada o su carpeta no figura en PATH. | Sigue la guía de instalación y abre una terminal nueva. |
| El agente no ve un archivo | Está fuera del workspace o no tiene permiso de lectura. | Abre la carpeta correcta o usa /add-dir solo si corresponde. |
| Un comando queda pendiente | La política requiere aprobación o acceso fuera del sandbox. | Lee la solicitud; aprueba, edita o rechaza conscientemente. |
| La tarea se desvía | El objetivo o las restricciones eran ambiguos. | Pulsa Esc, aclara el criterio y pide un plan más pequeño. |
| Hay demasiados cambios | El alcance permitió refactors o ediciones no relacionadas. | Revisa /diff, rechaza artifacts y vuelve a una base estable. |
| No aparece una conversación | Se abrió otro workspace o la sesión no es la esperada. | Comprueba la ruta y abre el selector con /resume. |
| Una integración no funciona | La Skill, MCP o plugin no cargó o carece de permisos. | Revisa /skills, /mcp, la configuración y los logs. |
| Los tests siguen fallando | La corrección no aborda la causa raíz o el entorno está incompleto. | Entrega el error exacto y pide comparar antes y después. |
Los problemas de descarga, autenticación, PATH y primera ejecución están explicados con más detalle en cómo instalar Antigravity CLI.
Ejemplo de workflow completo con agy
Imagina que un botón dejó de funcionar después de una actualización. Un recorrido controlado podría ser el siguiente:
Prepara el repositorio
Comprueba Git, reproduce el error y anota el comportamiento esperado.
Inicia agy
Abre la CLI desde la raíz, no desde una carpeta genérica del sistema.
Pide diagnóstico sin edición
Adjunta la captura, señala el componente y solicita la causa probable.
Revisa el plan
Confirma que solo afecte al componente, su lógica y el test de regresión.
Implementa y prueba
Autoriza los archivos correctos y el comando de test previamente definido.
Audita el resultado
Abre /artifact y /diff, reproduce el flujo y comprueba Git.
Cierra con evidencia
Pide archivos cambiados, pruebas ejecutadas, resultado y límites no verificados.
Fuentes oficiales de Antigravity CLI
Los nombres de comandos, atajos y comportamientos de esta guía fueron contrastados con la documentación vigente de Google. Como la CLI cambia con nuevas versiones, la referencia oficial debe prevalecer si una opción difiere de lo que muestra tu terminal.
Siguiente guía: cómo instalar Antigravity CLI
FAQ sobre Antigravity CLI
Antigravity CLI es la interfaz de terminal de Google Antigravity. Permite conversar con un agente local que puede explorar un repositorio, proponer planes, editar archivos, ejecutar comandos y presentar artifacts para revisión.
Utiliza el ejecutable agy. Debes abrir una terminal, entrar en la carpeta del proyecto y ejecutar agy para iniciar la TUI interactiva.
Sí. Puede leer y modificar archivos del workspace y proponer comandos de terminal. Cada acción depende de los permisos, reglas y sandbox configurados, por lo que puedes exigir aprobación previa.
Puedes abrir el panel de artifacts con Ctrl+R o /artifact y usar /diff para inspeccionar modificaciones. La interfaz permite aprobar, rechazar y comentar entregables antes de continuar.
Entre los más útiles están /help, /config, /permissions, /artifact, /diff, /resume, /rewind, /fork, /agents, /tasks, /skills, /mcp y /exit. Escribe una barra para ver la lista disponible en tu versión.
Sí. El agente principal puede delegar trabajo a subagentes concurrentes y el panel /agents permite supervisar su estado, registros y solicitudes de aprobación.
Sí. Puede cargar Agent Skills y conectarse a servidores Model Context Protocol. También admite plugins que agrupan Skills, agentes, reglas, MCP y hooks en un mismo paquete.
No. Antigravity CLI se usa desde la terminal con agy. Antigravity 2.0 es una aplicación independiente para organizar y supervisar agentes, mientras que el IDE ofrece una experiencia visual centrada en la edición de código.
Instala agy y prueba Antigravity CLI en un proyecto controlado
Comienza con una carpeta de prueba, conserva la revisión de permisos y utiliza Git para comparar cada cambio antes de delegar trabajo sobre un repositorio importante.
Ver cómo instalar Antigravity CLI →