Cómo instalar Antigravity CLI paso a paso
Aprende a instalar Google Antigravity CLI en Windows, macOS o Linux con el instalador oficial. Esta guía también explica cómo comprobar el comando agy, iniciar sesión, autorizar una carpeta de trabajo, corregir problemas con el PATH y completar la primera configuración sin confundir la CLI con Antigravity IDE.
¿Cómo se instala Antigravity CLI?
Antigravity CLI se instala mediante un script oficial alojado en antigravity.google. En macOS y Linux se ejecuta desde Terminal; en Windows puedes usar PowerShell o CMD.
macOS y Linux
curl -fsSL https://antigravity.google/cli/install.sh | bashWindows PowerShell
irm https://antigravity.google/cli/install.ps1 | iexWindows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmdDespués, abre una terminal nueva y comprueba la instalación con:
agy --versionSi aparece un número de versión, la CLI quedó instalada. A continuación, entra en la carpeta de un proyecto y ejecuta agy para autenticarte y completar la configuración inicial.
Requisitos para instalar Google Antigravity CLI
| Requisito | Qué necesitas | Por qué importa |
|---|---|---|
| Sistema operativo | Windows, macOS o una distribución Linux compatible | Google distribuye instaladores para los tres entornos. |
| Terminal | Terminal, PowerShell o CMD | La instalación y el uso de agy se realizan por comandos. |
| Conexión a internet | Acceso a antigravity.google y al inicio de sesión | El instalador descarga el binario y la autenticación abre el navegador. |
| Cuenta | Cuenta de Google, proyecto de Google Cloud o una Gemini API key configurada | La cuenta es la ruta más simple; la API key sirve para entornos sin navegador. |
| Navegador | Tu navegador predeterminado; el codelab oficial utiliza Chrome | Se utiliza para completar OAuth cuando no existe una sesión guardada. |
| Carpeta de trabajo | Un directorio propio o repositorio conocido | Antigravity pedirá permiso para leer, editar y ejecutar archivos allí. |
No necesitas instalar Node.js ni usar npm para obtener Antigravity CLI
El método oficial descarga un binario mediante el instalador de Google. Node.js, Python, Git u otras herramientas pueden ser necesarias para el proyecto que quieras desarrollar, pero no forman parte del comando básico de instalación de la CLI.
Cómo instalar Antigravity CLI en Mac
Abre la aplicación Terminal. Puedes encontrarla desde Spotlight escribiendo “Terminal”. Luego ejecuta el instalador oficial para macOS y Linux.
curl -fsSL https://antigravity.google/cli/install.sh | bashEspera a que el proceso termine y lee el mensaje final. El instalador guarda el ejecutable en ~/.local/bin/agy e intenta dejarlo disponible en el PATH. Si muestra una línea adicional para configurar el PATH, cópiala tal como aparece y ejecútala antes de continuar.
Comprobar la instalación en macOS
agy --version
agy --helpSi macOS responde que no encuentra el comando, cierra Terminal y ábrela de nuevo. Si el problema continúa, revisa la sección dedicada al PATH más adelante en esta guía.
Verifica el dominio antes de pegar cualquier instalador en Terminal
El comando oficial debe apuntar a https://antigravity.google/cli/install.sh. No sustituyas esa dirección por mirrors, acortadores o scripts publicados en tutoriales no oficiales.
Cómo instalar Antigravity CLI en Linux
Abre una terminal en tu distribución y ejecuta el mismo instalador oficial utilizado en macOS:
curl -fsSL https://antigravity.google/cli/install.sh | bashNo añadas sudo automáticamente. Primero utiliza el comando oficial como usuario normal y sigue las indicaciones que muestre el instalador. Así evitas entregar privilegios elevados sin que sean necesarios.
Si Linux no tiene cURL
Comprueba primero si está instalado con curl –version. Si el comando no existe, instala cURL mediante el gestor de paquetes de tu distribución y vuelve a ejecutar el instalador. Por ejemplo, en Ubuntu o Debian el paquete se llama curl.
Verificar que agy está disponible
command -v agy
agy --versionDe forma predeterminada, el binario se guarda en ~/.local/bin/agy. El primer comando muestra la ruta que está utilizando tu shell. El segundo confirma que Antigravity CLI puede iniciarse correctamente desde la terminal.
Cómo instalar Antigravity CLI en Windows
Google ofrece un instalador para PowerShell y otro para el Símbolo del sistema. Utiliza solamente uno. PowerShell suele ser la ruta más directa para usuarios de Windows 10 y Windows 11.
Opción 1: instalar con PowerShell
Abre PowerShell, pega el siguiente comando oficial y presiona Enter:
irm https://antigravity.google/cli/install.ps1 | iexirm es el alias de Invoke-RestMethod y iex ejecuta el contenido descargado. Por eso debes comprobar cuidadosamente que la dirección pertenezca al dominio oficial antes de ejecutarla.
Opción 2: instalar desde CMD
Si prefieres el Símbolo del sistema, utiliza este comando:
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmdEl proceso descarga temporalmente install.cmd, lo ejecuta y lo elimina cuando termina correctamente.
Comprobar Antigravity CLI en Windows
Por defecto, Windows registra el binario dentro de %LOCALAPPDATA%\agy\bin. Cierra la ventana, abre una terminal nueva y ejecuta:
agy --versionEn PowerShell también puedes localizar el ejecutable con Get-Command agy. En CMD utiliza where agy.
Qué hacer si “agy no se reconoce como un comando”
Este error suele significar que el archivo se instaló, pero la terminal todavía no conoce la carpeta donde se encuentra. Antes de reinstalar, revisa el mensaje final del instalador: normalmente indica la línea exacta que debes añadir al PATH.
Primero, reinicia la terminal
Cierra todas las ventanas de Terminal, PowerShell o CMD. Abre una nueva sesión y vuelve a probar agy –version. Los cambios del PATH no siempre se aplican a una terminal que ya estaba abierta.
Ejemplo para Bash en Linux
Si el instalador indica que el binario quedó en ~/.local/bin, una configuración habitual para Bash es:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcEjemplo para Zsh en macOS
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcEstos son ejemplos frecuentes, no una ruta universal. Utilízalos únicamente si coinciden con la carpeta informada por tu instalador.
Comprobar el PATH en Windows
Ejecuta Get-Command agy en PowerShell o where agy en CMD. Si no aparece ninguna ruta, vuelve a leer la salida del instalador y añade exactamente la carpeta que indique a la variable PATH de tu usuario. Después abre una terminal nueva.
Cómo iniciar Antigravity CLI por primera vez
Es recomendable iniciar la CLI desde una carpeta creada para tus proyectos. Así sabrás qué archivos puede leer y modificar el agente.
mkdir agy-cli-projects
cd agy-cli-projects
agyAl ejecutar agy por primera vez, Antigravity muestra un asistente interactivo. El recorrido puede cambiar ligeramente con nuevas versiones, pero el flujo oficial incluye autenticación, preferencias y confianza del espacio de trabajo.
Elige un método de inicio de sesión
Selecciona Google OAuth para usar una cuenta aprobada o Use a Google Cloud project cuando esa opción corresponda a tu entorno. La documentación avanzada también permite configurar una Gemini API key.
Completa la autenticación en el navegador
Inicia sesión y autoriza el acceso. Una sesión local puede volver automáticamente a la CLI. Si trabajas mediante SSH, copia la URL indicada en un navegador local y devuelve el código a la terminal.
Selecciona la apariencia
El asistente permite elegir un tema de color para la interfaz de terminal. Puedes modificarlo más tarde desde la configuración.
Elige el modo de renderizado
Puedes usar una pantalla alternativa de terminal o salida en línea integrada con el historial. Esta preferencia se puede cambiar posteriormente.
Revisa los términos y decide si confías en la carpeta
Tras aceptar las condiciones aplicables, autoriza el directorio solamente si es tuyo o conoces su contenido. La CLI advierte que podrá leer, editar y ejecutar archivos allí.
Escribe tu primera instrucción
Cuando aparezca el campo de entrada, la instalación y la autenticación ya estarán completas.
No aceptes automáticamente cualquier repositorio descargado
Revisa primero los archivos, scripts y dependencias de proyectos desconocidos. La confianza de una carpeta es una autorización importante porque un agente puede ejecutar herramientas y cambiar contenido dentro de ese espacio.
Cómo saber si Antigravity CLI quedó bien instalada
Una instalación funcional debe superar cuatro comprobaciones: el sistema encuentra el binario, la CLI responde, el inicio de sesión termina correctamente y la carpeta de trabajo se abre con los permisos esperados.
| Comprobación | Comando o acción | Resultado correcto |
|---|---|---|
| Binario | agy –version | Muestra una versión sin error. |
| Ayuda | agy –help | Presenta parámetros disponibles. |
| Inicio | agy | Abre la interfaz interactiva. |
| Autenticación | Google OAuth o Google Cloud | La sesión queda activa. |
| Workspace | Abrir una carpeta propia | Aparece la solicitud de confianza y luego el prompt. |
Comandos útiles después de instalar
| Comando | Función |
|---|---|
| /help | Abre la ayuda, los comandos y los atajos disponibles. |
| /config | Abre la configuración de permisos, tema, telemetría y otras opciones. |
| /settings | Accede a los ajustes desde la sesión interactiva. |
| /exit | Cierra la sesión; /quit funciona como alias. |
La referencia actual de Google identifica /exit como el comando principal de salida y /quit como su alias.
Qué permisos elegir después de instalar Antigravity CLI
Instalar la herramienta es solo el primer paso. Antigravity CLI puede leer archivos, proponer cambios y ejecutar comandos. Por eso conviene comenzar con un nivel de revisión que te permita confirmar acciones antes de que modifiquen el proyecto.
Empieza con revisión de herramientas
En /config, revisa la opción relacionada con permisos de herramientas. Un modo que solicite revisión es más apropiado mientras aprendes qué comandos ejecuta el agente y qué archivos modifica.
Evita saltarte permisos durante la primera prueba
La CLI puede ofrecer parámetros de ejecución autónoma. No los necesitas para verificar una instalación. Primero trabaja con un proyecto de prueba, revisa cada cambio y conserva tu código bajo control de versiones.
Usa Git antes de delegar cambios amplios
Crea un commit limpio antes de pedir refactorizaciones o tareas que afecten varios archivos. De esa manera puedes comparar el resultado y recuperar el estado anterior si una modificación no era la esperada.
Errores frecuentes al instalar Antigravity CLI
| Problema | Causa probable | Qué revisar |
|---|---|---|
| agy: command not found | La carpeta del binario no está en PATH. | Reinicia la terminal y aplica la línea mostrada por el instalador. |
| agy no se reconoce | Windows todavía no actualizó el PATH de la sesión. | Abre otra terminal y prueba Get-Command agy o where agy. |
| curl no existe | cURL no está instalado o disponible. | Instálalo con el gestor de paquetes o usa PowerShell en Windows. |
| La autenticación no abre | El navegador predeterminado o la sesión OAuth falló. | Copia la URL indicada, ábrela manualmente y devuelve el código a la terminal. |
| El código de acceso falla | Caducó, fue pegado incompleto o pertenece a otra sesión. | Reinicia agy y completa un nuevo flujo de autenticación. |
| No puede escribir archivos | La carpeta tiene permisos restringidos o no fue autorizada. | Usa un directorio propio y revisa la confianza del workspace. |
| Versión antigua | La CLI todavía no aplicó una actualización. | Reinicia agy o vuelve a ejecutar el instalador oficial para actualizar el binario. |
No reinstales antes de leer el error completo
La salida suele indicar si el problema corresponde al PATH, a la red, a la autenticación o a permisos del sistema. Guarda el mensaje exacto; “no funciona” no permite distinguir una instalación incompleta de una sesión que solo necesita reiniciarse.
Cómo actualizar Antigravity CLI
Antigravity CLI contiene un actualizador propio que comprueba versiones en segundo plano. Además, la documentación oficial indica que los mismos scripts sirven para instalar o actualizar el binario. En macOS o Linux puedes volver a ejecutar:
curl -fsSL https://antigravity.google/cli/install.sh | bashEn Windows, vuelve a utilizar el instalador oficial de PowerShell o CMD que elegiste inicialmente. Después, cierra la sesión interactiva, abre otra terminal y verifica el resultado con agy –version. No compares únicamente con un número publicado en un tutorial, porque la versión disponible puede cambiar.
Dónde se guardan los ajustes
La guía oficial sitúa la configuración de usuario en ~/.gemini/antigravity-cli/settings.json en sistemas tipo Unix. Siempre es preferible modificar opciones mediante /config o /settings; un JSON inválido puede impedir que la CLI arranque correctamente.
Lista final para completar la instalación
Usaste el dominio oficial
El instalador provino de antigravity.google.
La terminal reconoce agy
agy –version devuelve una versión válida.
Completaste el inicio de sesión
Google OAuth, tu proyecto de Google Cloud o la Gemini API key quedó configurada.
Elegiste una carpeta segura
El workspace es propio y conoces los archivos que contiene.
Revisaste los permisos
La configuración solicita confirmación antes de acciones sensibles.
Probaste la ayuda
/help y /config funcionan dentro de la sesión interactiva.
Fuentes oficiales para descargar Antigravity CLI
Los comandos de esta guía fueron contrastados con la página de descarga y los tutoriales oficiales de Google. Si Google modifica el proceso, esas páginas deben considerarse la referencia principal.
Siguiente guía después de instalar Antigravity CLI
Preguntas sobre la instalación de Antigravity CLI
Se instala con el script oficial de antigravity.google. macOS y Linux utilizan install.sh; Windows dispone de instaladores para PowerShell y CMD. Luego se verifica con agy –version.
El comando es agy. Conviene ejecutarlo desde la carpeta del proyecto que quieres analizar o modificar.
No para la instalación oficial de la CLI. Google distribuye un binario mediante sus scripts. Un proyecto concreto sí puede necesitar Node.js, Python u otras dependencias.
Sí. La página oficial ofrece un comando para PowerShell y otro para CMD. Tras instalar, abre una terminal nueva y ejecuta agy –version.
Normalmente porque la carpeta del ejecutable no quedó disponible en el PATH de la sesión. Reinicia la terminal y aplica exactamente la instrucción de PATH mostrada por el instalador.
No necesariamente. La ruta más sencilla usa una cuenta aprobada mediante Google OAuth o un proyecto de Google Cloud. La documentación oficial también permite configurar una Gemini API key para entornos headless o de integración continua.
La CLI dispone de un actualizador propio. También puedes volver a ejecutar el instalador oficial, que sirve para instalar o actualizar, y comprobar después el resultado con agy –version.
No. Antigravity CLI funciona desde la terminal mediante el comando agy. Antigravity IDE es un entorno de desarrollo visual con editor, panel de agentes y otras herramientas integradas.
Ahora ya puedes abrir Antigravity CLI desde cualquier proyecto con agy
Empieza en una carpeta de prueba, conserva la revisión de permisos y observa qué archivos y comandos utiliza el agente antes de delegar tareas mayores sobre un repositorio real.
Continuar con la guía de Google Antigravity →