Referencia de comandos · Antigravity CLI
agy --project <name>
Fija de forma explícita al iniciar qué proyecto se va a usar.
agy --project <name> es un flag de inicio para la invocación en la terminal (no es un slash command) y, según el changelog, se introdujo junto con --new-project en la versión 1.0.12. Determina explícitamente al arrancar qué proyecto existente se utiliza, en lugar de que la CLI deduzca automáticamente el proyecto a partir del directorio de trabajo actual.
Así complementa a agy --new-project <name>: mientras que --project carga un proyecto existente, --new-project siempre crea uno completamente nuevo.
Ambos flags ayudan a no depender de la detección automática de proyecto al arrancar — por ejemplo, cuando hay varios proyectos en el mismo directorio superior, o cuando un script invoca agy desde otro directorio de trabajo. Al igual que --new-project, --project solo es relevante al inicio, no se puede usar dentro de una sesión en curso.
✅ ¿CUÁNDO USARLO?
Seleccionar el proyecto independientemente de la carpeta
agy --project mein-projekt, aunque la terminal esté situada en ese momento en otro directorio
Referenciar de forma inequívoca en scripts
Invocar agy --project ci-projekt en un script de CI para asegurarse de que siempre se cargue el mismo proyecto
⛔ ¿CUÁNDO MEJOR NO?
Querer crear un proyecto completamente nuevo
--project solo selecciona entre proyectos existentes, pero no crea ninguno.
Mejor: Usar agy --new-project <name>
FUENTES
- Antigravity CLI CHANGELOG (GitHub) ↗ raw.githubusercontent.com
MÁS COMANDOS · Antigravity CLI