Antigravity CLI

Exécution

1. Définissez le répertoire de travail Bash sur le projet exact nommé par l'utilisateur et réglez un timeout fini, normalement 10 minutes.
2. Vérifiez la disponibilité avec command -v agy. S'il est manquant, arrêtez-vous et demandez à l'utilisateur d'installer Antigravity CLI dans Code Mate.
3. Exécutez une seule tâche et quittez :

agy -p "<prompt>" --output-format json

Passez le prompt comme un argument entre guillemets. Le mode print attend jusqu'à --print-timeout (5m par défaut) ; passez une valeur plus courte si le timeout du caller est plus serré.

Analysez le résultat JSON et lisez son champ status : tout ce qui n'est pas un statut de succès est un échec, et error contient la raison. Traitez également une sortie non analysable comme un échec. Ne lancez jamais Antigravity en mode interactif ou un flux d'authentification.

Authentification et permissions

Antigravity refuse de s'exécuter en mode headless tant qu'il n'est pas connecté — il retourne status: "ERROR" avec authentication failed or timed out et vous demande de lancer agy pour vous connecter. Ne faites pas cela : arrêtez-vous et demandez à l'utilisateur de terminer la configuration d'Antigravity dans Code Mate. Ne demandez, lisez, imprimez ou copiez jamais les credentials.

Le mode headless hérite du mode de permission persisté dans les paramètres utilisateur, et la lecture et l'écriture de fichiers dans l'espace de travail actif sont approuvées automatiquement par défaut — le défaut n'est pas une limite en lecture seule, et un prompt ne peut pas en faire une. Ne l'exécutez pas sur un projet modifiable pour une tâche en lecture seule. Utilisez une copie jetable ou en lecture seule à la place. Exécutez sur le projet réel uniquement quand l'utilisateur demande explicitement des modifications de l'espace de travail, limitez le répertoire et inspectez le diff ensuite. Ne passez jamais --dangerously-skip-permissions, qui approuve automatiquement chaque demande d'outil, y compris en dehors de l'espace de travail.

Exemple : pour une édition approuvée, demandez à Antigravity de ne toucher que les fichiers nommés, lancez-le dans ce projet, analysez la response et toute error signalée, et inspectez le diff résultant avant de signaler le succès.