Antigravity CLI

Antigravity CLI est l'outil en ligne de commande de Google. Il prend en charge, via le mode clé API, la connexion à des services compatibles avec l'API Gemini. Ce document explique comment configurer Antigravity CLI pour utiliser un point d'accès API personnalisé.

InstallationCopier le lien d’ancre

Choisissez la méthode d'installation selon votre système d'exploitation :

macOS / LinuxCopier le lien d’ancre

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

Windows (PowerShell)Copier le lien d’ancre

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

Windows (CMD)Copier le lien d’ancre

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

Vérification de l'installationCopier le lien d’ancre

agy --version

ConfigurationCopier le lien d’ancre

Activer le mode clé APICopier le lien d’ancre

Éditez ~/.gemini/antigravity-cli/settings.json et ajoutez au JSON existant :

{
  "modelProvider": "gemini"
}

⚠️ Attention : définir uniquement GEMINI_API_KEY ne change pas le mode d'authentification. modelProvider doit impérativement valoir "gemini" en minuscules.

Définir les variables d'environnementCopier le lien d’ancre

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"

Points importants :

• GOOGLE_GEMINI_BASE_URL reçoit l'adresse racine du service, sans chemin d'interface spécifique. Le point d'accès doit être compatible avec l'API Gemini.
• GEMINI_API_KEY reçoit votre clé API.
• Exécutez ces commandes dans le même shell que celui qui lance agy. La CLI ne lit ni .env ni GOOGLE_API_KEY.

Pour un effet permanent, écrivez les deux export dans ~/.zshrc ou ~/.bashrc.

Démarrage et vérificationCopier le lien d’ancre

agy --model gemini-2.0-flash

Une fois Gemini API key affiché en haut, engagez une conversation.

Dépannage des problèmes courantsCopier le lien d’ancre

• La connexion est toujours demandée : vérifiez "modelProvider": "gemini", puis quittez et relancez agy.
• Clé manquante au démarrage : redéfinissez GEMINI_API_KEY dans le shell courant.
• Échec des requêtes : vérifiez la clé API, l'adresse racine du service et les droits d'accès au modèle choisi.

RemarquesCopier le lien d’ancre

• La clé de configuration modelProvider et les variables d'environnement doivent être définies ensemble pour que le mode clé API fonctionne
• Les variables d'environnement doivent être définies dans la session de shell qui lance la CLI, ou écrites dans le fichier de configuration du shell pour un effet permanent
• Le point d'accès du service doit être conforme aux spécifications de l'API Gemini

Liens utilesCopier le lien d’ancre

• Documentation officielle : https://docs.aicentos.com/clients/antigravity-cli.html