Migrer de Gemini CLI vers Antigravity CLI : guide

Le 19 mai 2026, Google a annoncé qu’il mettrait fin à l’ancien Gemini CLI pour tous les forfaits Free, Pro et Ultra le 18 juin. Deux semaines après la publication de ce guide, la commande gemini cessera de traiter les requêtes. Migrer de Gemini CLI vers Antigravity CLI avec la commande agy est le seul moyen de rester dans l’écosystème des outils Google. agy est écrit en Go et démarre des dizaines de fois plus vite.

Si vous avez quelque chose qui tourne avec Gemini CLI — scripts CI, tâches cron nocturnes, extension IDE Gemini Code Assist — ce guide explique comment migrer en une soirée sans rien casser.

Qu’est-ce qui cessera exactement de fonctionner le 18 juin 2026 ?#

Il ne s’agit pas d’une « fermeture complète du projet », mais de l’arrêt des trois forfaits les plus populaires. Voici qui est concerné :

Extrait du blog officiel Google Developers :

Si vous utilisiez le forfait Free, comme la plupart des développeurs indépendants, et que vous vous dites « mais j’ai un compte payant », vérifiez précisément comment votre clé API est facturée. AI Pro n’est pas une facturation Cloud : c’est un abonnement Google AI personnel qui sera désactivé. La facturation Cloud associée à un projet payant ne sera pas interrompue.

Pourquoi Google arrête-t-il Gemini CLI ?#

L’ancien gemini démarrait en « centaines de millisecondes », car Node.js devait s’initialiser. Le nouveau agy est compilé sous la forme d’un unique binaire Go statique et démarre en « millisecondes ». Pour les pipelines CI et les scripts qui appellent le CLI des centaines de fois par exécution, la différence est notable.

Ce que Google indique sur la vitesse et les raisons de ce changement :

Toutes les fonctionnalités importantes de Gemini CLI ont été reprises :

• Agent Skills — le dossier .gemini/skills/ se trouve désormais dans .agents/skills/.
• Hooks — les mêmes événements (PreToolUse, PostToolUse, etc.) ; la syntaxe a très peu changé.
• Subagents — ils fonctionnent comme avant et leur configuration est migrée automatiquement.
• Extensions — renommées plugins Antigravity et importées en une seule commande.

Ce qui n’a pas été migré sans difficulté : les serveurs MCP et les anciens scripts qui accèdent directement à .gemini/config.json. D’après la discussion GitHub, certains utilisateurs signalent que les configurations MCP ne fonctionnent plus et doivent être réécrites manuellement. Une section distincte est consacrée à ce sujet plus bas.

Google ne ferme pas le projet open source Gemini CLI :

Cela signifie que vous pouvez le forker et continuer à l’utiliser avec votre propre clé Gemini API. Mais il s’agit désormais d’une configuration payante via la facturation Cloud ; l’offre gratuite Code Assist prend fin.

Installer Antigravity CLI : commandes pour macOS, Linux et Windows#

Avant de commencer, faites rapidement le point : quel forfait utilisez-vous ? Si vous avez un projet Cloud payant sans échéance au 18 juin, la migration est utile mais pas urgente. Si vous êtes sur Free/Pro/Ultra et que vous exécutez quelque chose avec le CLI, passez dès maintenant à Antigravity, tant que les forfaits sont encore actifs, pour pouvoir comparer le comportement sur la même tâche.

macOS et Linux

Une seule ligne avec curl :

curl -fsSL https://antigravity.google/cli/install.sh | bash

Le script détecte la plateforme, télécharge le binaire agy, vérifie sa somme de contrôle et le place dans ~/.local/bin. Si ce dossier ne figure pas dans PATH, ajoutez-le :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Vérifiez que le binaire est accessible :

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

Le binaire sera installé dans C:\Users\[your_name]\AppData\Local\agy\bin. L’installateur mettra automatiquement à jour PATH, mais ouvrez une nouvelle fenêtre PowerShell pour recharger les variables.

Windows (CMD)

Si PowerShell est bloqué par la politique de votre entreprise :

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Vérifier l’installation

Après l’installation, quel que soit le système d’exploitation, lancez :

agy doctor

La commande vérifie la version du binaire, l’existence d’une configuration, l’authentification et l’accès réseau à antigravity.google. Si Google est inaccessible, le problème vient de votre région ou de votre proxy.

Authentification

La première fois que vous lancez agy sans argument, un assistant de configuration démarre :

1. Choisissez un thème d’interface.
2. Choisissez une méthode d’authentification : Google OAuth (pour les comptes personnels) ou une clé API.
3. Vous pouvez importer immédiatement la configuration depuis .gemini/.

Si vous choisissez OAuth, un navigateur s’ouvre et vous redirige vers accounts.google.com ; vous devez consentir au partage des données. Ensuite, le CLI fonctionne.

Migrer la configuration et les plugins de .gemini vers .agents#

Étape par étape :

1. agy plugin import gemini

   Lancez la commande depuis n’importe quel dossier. Elle migre les plugins globaux de ~/.gemini/ vers ~/.agents/. Pour les plugins de l’espace de travail (à côté du projet), lancez la commande depuis le dossier du projet.

2. mv .gemini/skills/ .agents/skills/

   Déplacez les skills en renommant le dossier manuellement. Le format des fichiers reste identique ; il n’est pas nécessaire de réécrire le Markdown.

3. agy inspect

   Indique les plugins, skills, hooks et subagents actifs. Comparez cette liste à celle de Gemini CLI : rien ne devrait manquer.

4. agy config --edit

   Ouvre la configuration dans l’éditeur par défaut ($EDITOR). Si un élément n’a pas été récupéré automatiquement, modifiez-le manuellement.

5. agy doctor

   Vérification finale : binaire, authentification, plugins, réseau. Si les quatre éléments sont au vert, la migration de la configuration est terminée.

Je laisserais l’ancien dossier .gemini/ en place pendant un mois comme sauvegarde, au cas où quelque chose aurait été oublié. Après une semaine d’utilisation d’Antigravity et après avoir vérifié que tout est présent, vous pourrez le supprimer.

Si vous utilisez AGENTS.md comme configuration universelle pour tous les outils d’IA, vous n’avez rien à modifier. Antigravity CLI lit AGENTS.md dans le même dossier que Claude Code ou Codex.

Quelles variables d’environnement faut-il modifier ?#

Tableau complet des remplacements :

Si des GitHub Actions transmettent des secrets, ouvrez Settings -> Secrets -> Actions et renommez les clés. Les valeurs restent identiques (la clé API Google n’a pas changé pendant la migration).

Vérifiez tous les endroits où GEMINI_ peut apparaître :

# Rechercher les occurrences dans tout le projet
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# Dans les fichiers dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Après les remplacements, redémarrez le terminal et vérifiez la présence de la clé sans l’afficher. N’activez pas le traçage du shell et ne copiez aucune valeur de clé dans les journaux. La présence ne prouve pas l’autorisation ; inspectez séparément agy doctor :

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY est définie\n'
else
    printf 'AV_API_KEY est absente ou vide\n'
fi
agy doctor        # doit afficher “authorized”

Ce qui casse le plus souvent pendant la transition et comment y remédier#

Liste des problèmes initiaux :

1. Serveurs MCP. Si vous utilisiez mcp_servers dans .gemini/config.json, ils risquent de ne pas être récupérés après agy plugin import gemini. Vérifiez avec agy inspect : une section mcp doit apparaître. Si elle est vide ou contient des erreurs, réécrivez-la manuellement avec agy config --edit. Le format est décrit dans la documentation officielle d’Antigravity (consultez la section MCP).

2. Hooks personnalisés. Si vous aviez un script bash dans .gemini/hooks/ qui lisait $GEMINI_API_KEY, il ne fonctionnera plus. Recherchez les endroits concernés : bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Remplacez les variables.

3. CI/CD. Dans GitHub Actions ou GitLab CI, remplacez par agy les commandes qui utilisent gemini. Le nom du binaire dans l’installateur peut varier ; créez donc une abstraction à l’aide de la variable $CLI_CMD.

4. Extension IDE. L’extension Gemini Code Assist pour VS Code sera désactivée en même temps que le CLI. Son remplacement est Antigravity IDE (un fork distinct de VS Code) ou AGENTS.md dans tout autre éditeur d’IA.

5. Chargement avec @[file]. Les premières versions d’Antigravity CLI comportaient des bugs avec la commande @src/file.ts, qui sert à charger un fichier dans le contexte. Mettez à jour vers la dernière version : agy update.

Si un élément critique casse et ne peut pas être réparé en moins d’une heure, une solution temporaire pour le forfait Free consiste à rester sur Gemini CLI jusqu’au 18 juin et à configurer la migration sur une branche distincte du dépôt. Limite de temps : 14 jours.

Vaut-il la peine de rester avec les outils Google après le 18 juin ?#

Antigravity 2.0 peut être envisagé comme solution de secours lorsque votre outil principal (Claude Code ou Codex) ne convient pas. Pour découvrir en détail ses points forts et ses limites, consultez le guide de Google Antigravity 2.0.

Voici brièvement quoi faire selon votre situation :

Liste de contrôle de migration en 15 minutes#

1. Installer Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) ou irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Lancer agy et s’authentifier

   Sans argument : agy. Choisissez OAuth ou une clé API.

3. Importer les plugins depuis .gemini

   agy plugin import gemini — cette commande migre les extensions globales. Relancez-la dans le dossier du projet pour les plugins de l’espace de travail.

4. Déplacer les skills

   mv .gemini/skills/ .agents/skills/. Le contenu des fichiers reste inchangé.

5. Remplacer les variables d’environnement

   Dans ~/.zshrc/~/.bashrc et les fichiers .env : GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Redémarrez le terminal.

6. Vérifier l’installation

   agy doctor — les quatre éléments (binaire, authentification, plugins, réseau) doivent être au vert.

7. Exécuter une tâche de test

   agy "écris un README pour le projet dans le dossier actuel" — vérifiez que le résultat est similaire à celui de Gemini CLI.

8. Mettre à jour GitHub Actions / GitLab CI

   Modifiez le nom de la commande et les secrets, de GEMINI_* vers AV_*.

9. Garder .gemini/ comme sauvegarde

   Vous pouvez le supprimer une ou deux semaines après avoir vérifié que tout fonctionne.

Enfin, le 18 juin ne signifie pas que « tous vos projets vont tomber en panne ». Cela signifie que l’accès gratuit est désactivé. L’accès payant à l’API Cloud reste disponible, le dépôt Gemini CLI reste en ligne et les forks sont possibles. Si vous utilisiez le forfait Free, vous devez prendre une décision avant le 18 juin ; sinon, le prochain appel gemini "quelque chose" renverra une erreur d’autorisation.