Referencia de comandos · Antigravity CLI
install.sh --skip-path
Opción de PATH documentada que el instalador de shell no acepta.
La página de documentación antigravity.google/docs/cli/install indica --skip-path como un flag que debería impedir la adición automática al PATH en el perfil de shell durante la instalación. Sin embargo, el script bootstrapper realmente distribuido en antigravity.google/cli/install.sh (239 líneas, comprobado con curl el 27.07.2026) no reconoce este flag: su analizador de argumentos acepta exclusivamente -d/--dir (directorio de destino) y -h/--help. Cualquier otro parámetro, incluido --skip-path, cae en la rama de reserva *) y genera [ERROR] Unknown parameter: --skip-path, seguido de una interrupción con código de salida 1 — la instalación entonces ni siquiera llega a producirse.
A esto se suma que una búsqueda de «PATH=» en el script arroja solo un resultado, la variable interna BINARY_PATH para la ubicación de instalación del binario. El script no escribe en ningún momento en un perfil de shell ni establece ninguna variable PATH; solo descarga y verifica el binario y al final lo delega internamente a agy install. El propósito del flag descrito en la documentación carece por tanto de efecto actualmente, independientemente del valor de parámetro que se pase.
En Windows el comportamiento es distinto: install.cmd recopila los parámetros desconocidos en FORWARD_ARGS y los añade a SETUP_FLAGS, y install.ps1 hace lo mismo mediante $passthroughArgs. Allí, --skip-path no provoca una interrupción, sino que se reenvía sin comprobar a agy.exe install. No se puede determinar desde fuera si el binario interpreta o ignora ese parámetro — lo único observable es que la llamada no falla.
✅ ¿CUÁNDO USARLO?
Comprobar uno mismo, antes de instalar, qué flags acepta realmente el script distribuido en ese momento
curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --help
Usar solo el flag realmente compatible para ajustar el destino y gestionar el PATH manualmente después
bash install.sh --dir ~/bin
⛔ ¿CUÁNDO MEJOR NO?
Incluir --skip-path en la instalación por pipe, esperando que el PATH permanezca sin cambios
El script solo reconoce -d/--dir y -h/--help; --skip-path cae en la rama de reserva *), muestra «[ERROR] Unknown parameter: --skip-path» y se interrumpe con código de salida 1, antes incluso de instalar nada.
Mejor: ejecutar el script sin este flag, o comprobar antes con --help qué parámetros se admiten actualmente
Confiar únicamente en la descripción del flag en la documentación, sin comprobar el script distribuido
La página de documentación sigue listando --skip-path, pero el script distribuido en vivo en antigravity.google/cli/install.sh no lo admite (a fecha de 27.07.2026).
Mejor: verificar el script uno mismo con curl y --help antes de usarlo, en lugar de confiar ciegamente en la tabla de la documentación
FUENTES
- documentación de Antigravity CLI: Install ↗ antigravity.google