# Migrer de Gemini CLI vers Antigravity CLI : guide > Installation de agy, migration de la configuration, des plugins et des variables d’environnement ; vérifications, erreurs courantes et restrictions régionales. Source: https://ailoot.ai/blog/fr/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/fr/gemini-cli-to-antigravity-cli-migration/ Language: fr Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-f548aa91b0676a8f41dc6e78fbf37ee3731b8d4688d84d3c6ec2dfc039f89c6e 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.
La connexion aux modèles et l’utilisation de l’API sont présentées dans la [documentation Ailoot](https://ailoot.ai/docs/).
## Qu’est-ce qui cessera exactement de fonctionner le 18 juin 2026 ?
À retenir Le 18 juin 2026, Gemini CLI et l’extension Gemini Code Assist pour VS Code cesseront de traiter les requêtes pour trois catégories d’utilisateurs : ceux du forfait Free, de Google AI Pro et de Google AI Ultra. Les nouvelles installations de Gemini Code Assist sur GitHub ne seront plus disponibles ; les installations existantes seront désactivées « dans les semaines suivantes ». L’accès payant à l’API via Gemini Enterprise Agent Platform et les licences Code Assist Standard/Enterprise continueront de fonctionner sans changement.
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é : | Forfait | Ce qu’il proposait | Ce qui se passera le 18 juin 2026 | |----|----|----| | Forfait Free | Accès à Gemini Code Assist et CLI avec des limites | Désactivation complète | | Google AI Pro (environ \$19.99/mois) | Limites plus élevées pour CLI et Code Assist | Désactivation complète | | Google AI Ultra (à partir de \$100/mois après I/O 2026) | Les limites les plus élevées | Désactivation complète | | Gemini Code Assist pour GitHub | Révisions automatiques des PR de votre dépôt par Google | Aucune nouvelle installation ; les installations existantes seront désactivées dans les semaines suivantes | | Gemini Code Assist Standard / Enterprise (licences d’entreprise) | Via un compte Google Workspace d’entreprise | Fonctionnera sans changement | | API payante via Google Cloud (clé API Gemini payante) | Requêtes facturées au projet | Fonctionnera sans changement | Extrait du blog officiel Google Developers :

Le 18 juin 2026, Gemini CLI et les extensions IDE Gemini Code Assist cesseront de traiter les requêtes pour les utilisateurs de Google AI Pro, Ultra et du forfait Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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 ?
À retenir Gemini CLI était une expérience distincte en TypeScript/Node.js dans le dépôt GitHub de Google. Google a décidé de réunir tous ses outils d’agent sur une plateforme unique — Google Antigravity — avec quatre interfaces : Antigravity 2.0 (application de bureau), Antigravity CLI (terminal), Antigravity SDK (wrapper Python) et Antigravity IDE (fork de VS Code). Antigravity CLI a été réécrit de Node.js en Go : il démarre en quelques millisecondes plutôt qu’en centaines de millisecondes et utilise des dizaines de mégaoctets de mémoire plutôt que des centaines.
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 :

Antigravity CLI est écrit en Go, s’exécute plus rapidement et prend en charge les workflows asynchrones en arrière-plan.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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 :

Le dépôt restera disponible sur GitHub sous licence Apache 2.0, et nous continuerons à travailler sur le projet en open source.

— Google Developers Blog (Discussion #27274)
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
À retenir L’installateur Google détecte automatiquement le système d’exploitation et l’architecture, télécharge le binaire et le place dans `~/.local/bin` (Linux/macOS) ou `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Les commandes diffèrent selon le système : sur macOS et Linux, une seule ligne avec `curl` ; sur Windows, PowerShell `irm` ou l’option CMD. Après l’installation, ajoutez le chemin à `PATH` si l’installateur ne l’a pas fait, ouvrez un nouveau terminal et lancez `agy doctor` : l’outil vérifie que le binaire a été trouvé et qu’il peut joindre Google.
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` : ```bash 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 : ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Vérifiez que le binaire est accessible : ```bash which agy agy --version ``` ### Windows (PowerShell) ```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 : ```cmd 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 : ```bash 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
À retenir Antigravity CLI recherche sa configuration dans `.agents/`, à côté du projet, et globalement dans `~/.agents/`, comme Gemini CLI la recherchait dans `.gemini/`. La migration s’effectue avec une seule commande, `agy plugin import gemini` : elle parcourt `.gemini/extensions/`, migre les extensions en tant que plugins Antigravity et met à jour le format de configuration. Déplacez manuellement le dossier des skills : `mv .gemini/skills/ .agents/skills/`. Ensuite, `agy doctor` et `agy inspect` indiquent ce qui a été récupéré, ce qui manque et où se trouvent les doublons.
É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](https://ailoot.ai/blog/fr/agents-md-guide-template/), 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 ?
À retenir Si vous avez des scripts CI/CD, des GitHub Actions, des fichiers `.env` locaux ou des fichiers dotfiles qui transmettent `GEMINI_API_KEY` ou d’autres variables, vous devez les renommer. Le préfixe `GEMINI_` est devenu `AV_` (pour Antigravity). Antigravity CLI ne lira PAS les anciennes variables.
Tableau complet des remplacements : | Ancienne variable (Gemini CLI) | Nouvelle variable (Antigravity CLI) | Valeur par défaut | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Point de terminaison officiel de Google | 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 : ```bash # 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` : ```bash 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
À retenir D’après la discussion GitHub, les problèmes les plus fréquents concernent les serveurs MCP définis dans `~/.gemini/config.json`, qui ne sont pas récupérés automatiquement : il faut réécrire la configuration au format Antigravity. Les hooks personnalisés qui utilisent d’anciennes variables d’environnement échouent silencieusement ; les tests échouent donc sans message d’erreur clair. Les scripts qui accèdent directement à `.gemini/` plutôt que de passer par le CLI doivent être mis à jour pour utiliser `.agents/`. La commande `@[file]` servant à charger un fichier dans le contexte comportait des bugs lors du lancement d’Antigravity CLI ; ils ont été corrigés dans les versions récentes. Si vous utilisez une ancienne version, mettez-la à jour.
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](https://antigravity.google) (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 ?
À retenir Antigravity CLI démarre plus vite, fonctionne avec Gemini 3.5 Flash, prend en charge les agents parallèles et les tâches asynchrones en arrière-plan via `agy --background`. Deux problèmes potentiels se posent toutefois : les restrictions d’accès régionales et un écosystème encore immature (moins de plugins et de serveurs MCP que dans Claude Code). Je ne choisirais pas Antigravity comme outil principal. Je l’utiliserais comme canal de secours pour des tâches parallèles en arrière-plan, tout en gardant Claude Code pour l’essentiel du développement. Si vous utilisiez Gemini CLI avec le forfait Free, le 18 juin est une bonne occasion de repenser l’ensemble de vos outils.
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](https://ailoot.ai/blog/fr/google-antigravity/). Voici brièvement quoi faire selon votre situation : | Si vous… | Que faire d’ici le 18 juin | |----|----| | Utilisiez Gemini CLI Free pour des expérimentations | Migrez vers Antigravity CLI avec un compte pouvant accéder au service OU passez à Claude/Codex, selon votre budget | | Utilisiez Gemini Code Assist dans votre IDE | Passez à Antigravity IDE ou revenez à VS Code + Claude Code | | Exécutiez des tâches cron nocturnes via l’API Gemini du forfait Free | Réécrivez-les de toute urgence pour l’API Cloud payante (qui ne sera pas désactivée) OU passez à l’API Claude | | Travaillez via le Cloud d’entreprise (Standard/Enterprise) | Ne faites rien ; l’arrêt ne vous concerne pas | | Pensiez essayer Gemini CLI parce qu’il est « gratuit » | Ne commencez pas ; passez directement à [Claude Code](https://ailoot.ai/blog/fr/claude-code/) ou [Codex](https://ailoot.ai/blog/fr/codex-vs-claude-code-choice/) | ## Liste de contrôle de migration en 15 minutes
À retenir Si vous voulez aller au plus vite sans lire tout le guide, voici la séquence abrégée. Dans un terminal vierge, sans scripts Gemini actifs, la migration complète prend 10–20 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.
### Sources - [Google Developers Blog - Mise à jour importante : transition de Gemini CLI vers Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Premiers pas](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - Dépôt GitHub](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Temps forts de Google I/O 2026 pour les développeurs](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Continuez à travailler avec l’IA sur [Ailoot](https://ailoot.ai/).
## Questions fréquentes : Migrer de Gemini CLI vers Antigravity CLI : guide ### Comment vérifier la variable de clé renommée sans l’exposer ? Testez si ${AV_API_KEY:-} est non vide et affichez seulement un message de présence ou d’absence. N’affichez pas la valeur et désactivez le traçage du shell. Inspectez séparément l’authentification avec agy doctor. ### Un import de configuration réussi termine-t-il la migration ? Non. Comparez plugins, skills, hooks et sous-agents actifs à l’ancienne configuration, inspectez MCP et testez une petite tâche. Conservez .gemini/ jusqu’à vérification du parcours et du résultat attendus. ## Ailoot · L’entreprise et son portefeuille de projets Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI. L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois. Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.