FR
Neuractif

Guide de survie Antigravity V2 et l’écosystème Agentique Google (après la I/O-2026)

• TECHNIQUE
Guide de survie Antigravity V2 et l’écosystème Agentique Google (après la I/O-2026)

Nous sommes fin mai 2026. Suite aux récentes annonces de Google I/O et au déploiement de la version majeure d’Antigravity V2, de nombreux développeurs se retrouvent face à des comportements erratiques : Token Budget saturé, commandes slash / disparues, et workflows personnalisés (comme BMAD) cassés.

Ce guide est un retour d’expérience (appuyé par les documentations officielles et quelques retours de la communauté Google.Dev et Github) pour vous aider à migrer sans douleur (du moins, pas assez douloureusement quand même 😎).

Et surtout, DISCLAMER : ce guide assume que :

  • vous étiez déjà utilisateur de l’écosysteme agentique Antigravity depuis une version v1.x au moins,
  • vous êtes familiers avec les “chemins de fichiers” dans un systèmes unix,
  • vous exploitiez déjà des workflows avancés pour des projets moyens à complexes.
  • vous resterez au courant des évolutions de cette version majeure v2.x afin de réajuster vos config si jamais elles changent encore officiellement lors d’une prochaine upgrade.

0. Deux applis (distinctes) désormais pour Antigravity

La V2 a introduit deux lanceurs pour Antigravity : l’IDE se distingue du Agent Manager avec son nom “Antigravity IDE”. Et pour ce qui est de la commande de lancement dans le Shell, vous pouvez aussi lancez uniquement l’éditeur dans un répertoire directement en invoquant la commande $ `antigravity-ide .`ou `agy-ide .`

1. La crise du « Token Budget » (Customization Budget)

Le symptôme
Après la mise à jour, votre jauge de Token Usage dans les réglages (Customizations) explose dans le rouge (parfois à plus de 500%), affichant l’alerte :
« Customization token budget exceeded ».

Pourquoi ? 
La V2 tente par défaut de pré-charger (hydrater) l’intégralité des dossiers de Skills globaux présents sur votre machine dans le System Prompt de l’agent. Si vous aviez des centaines de compétences téléchargées (ex: packages BMAD complets), l’agent sature avant même de commencer à réfléchir.

La solution (l’approche « Opt-in »)

L’automatisation du tri par l’agent est inefficace en V2 (coût de latence). Il faut passer d’une logique globale à une logique locale par projet.

  1. Désactivez le “GLOBAL” :
    Renommez vos dossiers de skills globaux pour les sortir du radar de l’IDE.
  • ~/.gemini/config/skills => ~/.gemini/config/skills_unused
  • ~/.gemini/antigravity-ide/skills => ~/.gemini/antigravity-ide/skills_unused
  1. Ciblez par projet :
    Quand vous démarrez un projet, utilisez des liens symboliques (symlinks) pour n’importer que les skills nécessaires dans le dossier du projet : <racine-du-projet>/.agents/skills/.

2. Le renommage officiel : “.agent” vs .”agents”

Avec la V2, Google a rationalisé le nommage pour s’aligner sur les standards de l’industrie (et faciliter la compatibilité avec des outils comme OpenClaw etc.).

  • .agent (Singulier) : ce format est désormais déprécié (deprecated).
  • .agents (Pluriel) : est le nouveau standard officiel. depuis un bon moment déjà.
    Action : Renommez systématiquement vos dossiers locaux en “.agents/” pour éviter les bugs de découverte du scanner.

3. Disparition des Slash “/” Commands & Workflows (erreur silencieuse)

Le symptôme

Vous tapez / dans le chat, et vos workflows habituels (BMAD, start-session, audit…) renvoient « 0 matching results ». Parfois, une erreur ConnectError: [unknown] uri: «  » apparaît si vous tentez d’en créer un nouveau.

Les deux causes majeures :

A. La migration silencieuse des dossiers

La V2 a modifié l’emplacement par défaut où l’IDE cherche les workflows globaux.

  • Ancien chemin V1 : ~/.gemini/antigravity-ide/global_workflows/
  • Nouveau chemin V2 : ~/.gemini/config/global_workflows/ 


Action : Déplacez physiquement vos fichiers .md de l’ancien vers le nouveau dossier.

B. Le crash du Parser V2 (File Isolation)

Le nouveau Discovery Scanner d’Antigravity est impitoyable. S’il détecte un seul fichier Markdown mal formaté (erreur YAML, description vide, etc.) dans votre dossier global_workflows, il crashe silencieusement et désactive TOUTES vos autres commandes saines.
Action : Isolez vos anciens workflows dans un dossier de backup. Ne réintroduisez que les fichiers ultra-simples et validés un par un. Évitez de masquer des « personas » (skills) dans le dossier des workflows.

C. L’erreur uri: «  »

Cette erreur survient si vous tentez de charger des workflows globaux alors qu’aucun projet/workspace n’est ouvert dans l’éditeur. Antigravity V2 a impérativement besoin d’un ancrage de projet actif pour résoudre le schéma de l’URI (file://).

4. Et GeminiCLI dans tout ça ?

Si vous utilisez GeminiCLI dans votre shell, vous êtes relativement à l’abri de ce petit chaos. Contrairement à l’IDE qui utilise des fichiers Markdown, GeminiCLI s’appuie sur une architecture de fichiers .toml qui n’a pas été impactée par la refonte des dossiers de l’IDE.

  • Vos commandes globales restent en sécurité dans : ~/.gemini/commands/
  • Vous pouvez les recharger à chaud sans redémarrer via : /commands reload

Références et quelques liens utiles

Prenez le temps de faire ce ménage sur vos machines avant de lancer vos agents sur des tâches complexes !

Back to blog