Antigravity CLI (agy) sur un serveur

Depuis le 18 juin 2026, Gemini CLI ne sert plus les comptes personnels gratuits, Google AI Pro ou Ultra. L'annonce de Google oriente ces utilisateurs vers l'Antigravity CLI, agy. Sur un serveur, les points délicats sont la connexion sans navigateur, le choix entre connexion Google et clé API, et la façon dont agy gère les autorisations quand personne n'est devant le terminal. Les voici dans l'ordre.

Installer agy

Sur Linux ou macOS, avec votre utilisateur normal (non root) :

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

La page d'installation officielle indique que le binaire est placé dans ~/.local/bin/agy et liste macOS, Linux et Windows. L'installeur récupère un build par plateforme, avec des builds Linux pour amd64 et arm64, donc un VPS ARM convient. Ajoutez la ligne PATH à ~/.bashrc ou ~/.profile pour que les nouveaux shells et fenêtres tmux en tiennent compte.

Une habitude propre aux serveurs : agy se met à jour tout seul en arrière-plan. C'est pratique sur un portable. Sur une machine que vous laissez tourner, cela signifie que la version peut changer sous une longue session. Maude fige la version qu'il installe et désactive ce comportement avec AGY_CLI_DISABLE_AUTO_UPDATE=1. Si vous voulez la même prévisibilité, exportez cette variable dans le shell ou l'unité qui lance agy.

Se connecter via SSH

Lancez agy dans une session SSH et choisissez la connexion Google. Sur un portable, il ouvrirait un navigateur. Via SSH, il détecte la session distante et affiche à la place une URL d'autorisation. Ensuite :

1. Copiez l'URL et ouvrez-la sur votre téléphone ou votre portable.
2. Connectez-vous avec le compte Google que vous utilisez pour Antigravity.
3. Copiez le code que la page vous donne et collez-le dans le terminal.

Les identifiants sont stockés dans le trousseau du système, c'est-à-dire le Secret Service sous Linux. Un VPS nu n'a pas de session de bureau pour déverrouiller un trousseau. Une issue GitHub ouverte sur agy 1.0.0 signale une boucle de connexion sur Linux headless causée précisément par cela, plus un bug de fuseau horaire dans le stockage de repli en fichier. La solution de contournement de l'auteur était GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Nous n'avons pas vérifié si les versions actuelles en ont encore besoin. Si agy vous redemande de vous connecter à chaque lancement, c'est la première piste à explorer. Sinon, utilisez le mode clé API.

Pour vous déconnecter et purger le profil enregistré, lancez /logout dans agy.

Le mode clé API pour le headless

Pour la CI, une machine partagée ou tout serveur sur lequel vous préférez ne pas garder de session Google, faites tourner agy avec une clé API Gemini. La documentation d'installation donne deux étapes. D'abord, définissez le fournisseur de modèles dans ~/.gemini/antigravity-cli/settings.json, en le fusionnant dans le fichier s'il existe déjà :

{
  "modelProvider": "gemini"
}

Puis rendez la clé disponible pour le processus :

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Cela supprime entièrement la connexion au compte. L'usage est facturé au token selon les tarifs de l'API Gemini au lieu d'être décompté d'un forfait Google AI. Gardez la clé hors de l'historique du shell et hors du dépôt sur lequel travaille l'agent.

Les autorisations quand personne ne regarde

C'est le comportement serveur qui surprend le plus. Lors de nos tests sur agy 1.2.14, les exécutions headless (agy -p …, ou le mode stream-json) ne peuvent pas s'arrêter pour demander avant d'exécuter un outil. Une commande ou une écriture de fichier qui exige une autorisation est refusée, et le résultat du tour la signale comme refusée. Vous avez trois moyens de laisser passer le travail :

• Les règles d'autorisation. agy les lit dans permissions.allow de ~/.gemini/antigravity-cli/settings.json. Les entrées ressemblent à "command(npm test)", "write_file(src/app.ts)" ou "command(*)". Elles sont lues au démarrage.
• Les modes. --mode accept-edits approuve automatiquement les modifications de fichiers, mais les commandes restent refusées. --mode plan planifie sans agir.
• Aucun contrôle. --dangerously-skip-permissions, pour une machine jetable. Lisez faire tourner des agents avec toutes les autorisations, en sécurité avant d'y recourir.

agy en interactif dans un terminal, et Remote Control (ci-dessous), peuvent s'arrêter pour demander. Cette limite concerne donc spécifiquement l'usage scripté et headless.

Reprendre votre configuration Gemini CLI

Le guide de migration couvre le sujet. En bref, pour un serveur qui avait déjà Gemini CLI :

• Le premier lancement propose la migration. Si agy trouve une configuration Gemini CLI existante, il affiche une liste des extensions et des paramètres globaux à convertir.
• Les extensions deviennent des plugins. Lancez agy plugin import gemini à tout moment pour convertir les extensions Gemini en plugins Antigravity.
• Les fichiers de contexte fonctionnent tels quels. GEMINI.md (dans l'espace de travail et ~/.gemini/GEMINI.md) et AGENTS.md sont lus sans modification.
• Les serveurs MCP demandent une petite retouche. Les serveurs globaux se trouvent dans ~/.gemini/config/mcp_config.json, ceux de l'espace de travail dans .agents/mcp_config.json. Renommez les anciennes clés url/httpUrl en serverUrl.
• Les skills déménagent. Les skills d'espace de travail passent de .gemini/skills/ à .agents/skills/, et les skills globaux vont dans ~/.gemini/antigravity-cli/skills/. Vous devez les déplacer vous-même.

Google reconnaît que la parité fonctionnelle n'est pas encore totale, et le guide de migration signale que certains thèmes personnalisés et réglages visuels ne sont pas repris. Si un flux de travail dépend d'une extension précise, testez-le après l'import avant de supprimer l'ancienne configuration.

Le daemon Remote Control ou Maude

Google propose un moyen officiel de joindre agy depuis un autre appareil. Selon la documentation Remote Control, vous pouvez le lancer de trois façons :

• /remote-control dans une session en cours. Le tunnel se ferme quand cette session CLI se termine.
• agy --remote-control au lancement d'une session. Ce tunnel se ferme lui aussi quand la session se termine.
• Le daemon headless : agy remote-control start --name my-vps, avec agy remote-control status et agy remote-control stop. Il enregistre un service système qui continue de tourner en arrière-plan.

Vous le contrôlez depuis un tableau de bord web dans n'importe quel navigateur, connecté au même compte Google. La documentation indique que vous pouvez installer le tableau de bord sur l'écran d'accueil de votre téléphone pour recevoir des notifications push, et que vous pouvez répondre aux demandes d'autorisation depuis le terminal comme depuis l'interface à distance. Elle précise aussi qu'un paramètre de fonctionnalité du compte ou de l'organisation peut le bloquer.

Si Antigravity est le seul agent que vous utilisez et que le paramètre est activé pour votre compte, le daemon officiel est le premier choix évident. Il est gratuit, et il peut demander avant d'agir.

Le piloter depuis votre téléphone

Si vous voulez agy sur un serveur à côté d'autres agents, piloté depuis une app native, Maude est une option. Ajoutez le serveur, et l'app installe agy dans une version testée et vous connecte depuis le téléphone. Vous pouvez utiliser la connexion Google avec un code collé ou une clé API Gemini. Pour être transparent sur Antigravity dans Maude : comme Maude pilote agy en headless, il ne peut pas s'arrêter pour demander avant d'exécuter un outil. Maude vous montre l'action refusée et, si vous la validez, ajoute une règle d'autorisation et relance. La page de l'agent Antigravity donne les détails. Le changement de Gemini CLI lui-même, et les autres options vers lesquelles les gens se sont tournés, sont traités dans notre article sur l'arrêt de Gemini CLI.

Questions fréquentes

Ce qui a changé

• 1 octobre 2026 — Première publication. Détails d'installation, d'authentification, de migration et de Remote Control vérifiés dans la documentation d'antigravity.google ; comportement des autorisations en headless issu de nos propres tests sur agy 1.2.14.