Sommaire du dépannage
Diagnostiquer l’erreur Antigravity avant de modifier la configuration
Antigravity ne fonctionne pas peut décrire des pannes très différentes. Certaines viennent du service cloud ou du compte, d’autres de Node.js, du PATH, d’un proxy, d’un MCP ou d’un ancien build. Le texte exact de l’erreur doit guider la réparation.
Copiez le message et notez où il apparaît. Si l’application ne démarre pas, vérifiez l’OS, l’architecture et les protections de sécurité. Si la connexion boucle, vérifiez navigateur, cookies et heure système. Si l’agent échoue, cherchez modèle, quota, réseau, MCP et contexte. Si le terminal échoue, cherchez PATH, Node.js, npx, npm et politique shell.
Avant de demander de l’aide, notez le message exact, son moment d’apparition, le système et la version de l’app visibles dans À propos, sa présence dans un espace propre et les changements récents concernant Node.js, PATH, le proxy ou les outils MCP. Reproduisez le problème dans un petit projet local avec une instruction courte. Avant de partager des journaux, retirez les chemins personnels, e-mails, jetons d’accès, cookies, clés API et code privé. Ne publiez pas une archive complète de diagnostic. Ces éléments aident à orienter le problème Antigravity vers l’app, le compte, le réseau, le terminal ou l’espace de travail sans répéter des réinstallations risquées.
| Symptôme | Cause probable | Premier correctif |
|---|---|---|
| Agent execution terminated due to error | Route modèle temporaire, session, réseau instable, crash MCP ou limite de contexte. | Redémarrez l’agent, testez un petit prompt dans un workspace propre, puis désactivez MCP seulement si ce test fonctionne. |
| Model API cannot be reached | Pare-feu, proxy, DNS, région non prise en charge, session expirée ou disponibilité du service. | Confirmez la connexion, testez un autre réseau fiable et autorisez les endpoints Google AI. |
| exec: "npx": executable file not found in PATH | Antigravity n’hérite pas du même environnement que le terminal ou Node.js manque. | Installez Node.js LTS, vérifiez npx dans le terminal puis corrigez le PATH utilisateur ou système. |
| PowerShell execution policy is blocking npx | La politique Windows bloque les scripts npm. | N’utilisez qu’un changement de politique approuvé ou une invocation MCP compatible cmd. |
| L’installateur s’ouvre mais l’app ne démarre pas | Mauvaise architecture, ancien processus, OS non supporté, antivirus ou dossier corrompu. | Vérifiez les prérequis, fermez les processus et installez le bon build x64, ARM64, Apple Silicon, Intel, apt ou dnf. |
Correctifs rapides pour les pannes fréquentes
Si l’app s’ouvre mais se comporte mal, consultez À propos et la page officielle de téléchargement Google avant de modifier les réglages. Fermez tous les processus, utilisez uniquement l’installateur publié là, relancez Antigravity avec le raccourci habituel et vérifiez la version. Si l’ancienne version reste affichée, recherchez un vieux raccourci ou une installation en double.
Redémarrez l’agent avant de changer les réglages. Lancez un prompt court dans un petit dossier. Si ce test échoue, regardez compte, réseau, version ou outils globaux. S’il fonctionne, le problème se trouve probablement dans le dépôt.
Contrôlez la route réseau lorsque le message parle d’API modèle, région, timeout ou trafic élevé. Une autre connexion fiable permet de distinguer une panne réseau d’une installation cassée.
Workflow de récupération Antigravity
Notez l’erreur exacte et la version
Si l’app s’ouvre, notez la version dans À propos et copiez le message exact avant de réinstaller.
Testez un workspace propre
Testez une instruction courte dans un dossier propre ; si elle fonctionne, examinez les outils et règles du projet d’origine.
Réparez la bonne couche
Mettez à jour uniquement en cas de problème de build ; corrigez PATH, la stratégie du shell ou la commande MCP concernée.
Correctifs par texte d’erreur
Appliquez seulement la voie qui correspond au message. Cela évite de casser une configuration qui fonctionnait.
Agent execution terminated due to error : checklist ciblée
Lorsque cette erreur exacte apparaît, séparez le routage modèle des crashes d’outils locaux. Testez d’abord un prompt d’une ligne dans un dossier propre. Si cela fonctionne, réactivez les serveurs MCP un par un, réduisez le contexte et repérez l’étape shell, npx ou navigateur qui termine. Pour le message exact 'agent execution terminated due to error', notez l'etape qui echoue avant de relancer : reponse du modele, commande de terminal, action navigateur ou outil MCP. Un echec toujours lie au meme outil local indique plutot la configuration ; un echec avant tout outil indique plutot la connexion, le routage, le quota ou le reseau.
Corriger agent execution terminated due to error
Ouvrez un dossier minimal et demandez à l’agent de lire un seul fichier. Si cela échoue aussi, rafraîchissez la connexion, redémarrez Antigravity, changez de modèle si possible et réessayez plus tard. Si seul le vrai dépôt échoue, inspectez MCP, gros fichiers, règles workspace et prompts trop chargés.
Corriger npx introuvable dans PATH
Installez Node.js LTS, ouvrez un nouveau terminal et exécutez node -v, npm -v et npx -v. Si ces commandes fonctionnent dehors mais pas dans Antigravity, lancez l’app depuis ce terminal ou ajoutez Node.js au PATH.
Corriger les blocages PowerShell
Sur Windows, npm et npx peuvent appeler des scripts bloqués par la politique PowerShell. N’exécutez pas de scripts inconnus. Utilisez une politique utilisateur approuvée ou une commande MCP compatible.
Corriger les boucles de connexion et l’API modèle
Vérifiez l’heure système, le navigateur par défaut, les cookies et la session. Si l’erreur parle de région, quota ou trafic élevé, réinstaller aide rarement.
Corriger installation et mise à jour
Choisissez le bon installateur : Windows x64 ou ARM64, macOS Apple Silicon ou Intel, dépôt Linux compatible. Fermez les processus et remplacez les raccourcis obsolètes après confirmation.
Application et version
Comparez À propos à la page Google, fermez les processus et vérifiez la cible du raccourci au redémarrage.
Agent et modèle
Testez une instruction propre et un autre réseau de confiance pour séparer les problèmes de projet, compte, réseau ou service.
Terminal, Node.js et MCP
Vérifiez node, npx, PATH, la stratégie du shell et la commande MCP concernée depuis un terminal externe.
Éviter que Antigravity retombe en panne
Après une modification de Node.js ou PATH, redémarrez l’application et comparez node et npx dans les deux terminaux.
Sauvegardez les réglages avant d’effacer les caches ; testez MCP un par un et n’exécutez que des commandes comprises.
Note de sécurité
N’exécutez pas de commandes PowerShell, curl ou shell copiées au hasard sans les comprendre. Un correctif IDE ne doit pas exposer votre code, vos tokens ou votre session.
Liens officiels et internes utiles
Utilisez ces pages pour vérifier l’installateur, la compatibilité et la mise à jour après avoir identifié la panne.
- Page officielle de téléchargement Antigravity - destination officielle des installateurs Google
- Dépannage officiel CLI Antigravity - référence officielle pour la ligne de commande
- Prérequis Antigravity - vérifier OS, architecture, mémoire, stockage et réseau
- Guide de mise à jour Antigravity - corriger les alertes de version obsolète