Cheat Sheet Référence rapide
Français

Langue

Référence rapide

Aide-mémoire Google Antigravity CLI (agy) : Commandes et configuration

Guide de référence rapide pour l'agent de programmation en terminal Google Antigravity CLI (agy) : options de démarrage et sous-commandes, commandes slash et raccourcis TUI, configuration .agents/ et mcp_config.json, et check-list de migration depuis Gemini CLI.

· Publié le

Antigravity CLI (agy) est l'agent de programmation léger et natif en terminal de Google, écrit en Go au sein de la plateforme Antigravity 2.0. Conçu pour l'exécution parallèle de sous-agents, l'isolation par Git worktree, les Agent Skills, les plugins et les intégrations MCP, agy remplace le client grand public Gemini CLI.

Cet aide-mémoire couvre les options et sous-commandes de agy CLI, les commandes slash interactives, les raccourcis clavier, la configuration via .agents/ et mcp_config.json ainsi que les étapes de migration depuis Gemini CLI.

🔗 Aides-mémoire associés : Comparatif des CLI d'agents de codage en terminal · Aide-mémoire Claude Code CLI · Aide-mémoire OpenAI Codex CLI · Architecture des compétences d'agents IA (Skills)

1. Installation, sous-commandes et options de démarrage

1.1 Installation et lancement

# Installer Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Lancer la TUI interactive (suivez les instructions d'authentification au premier lancement)
agy

1.2 Sous-commandes principales et options de démarrage

Commande / Option Description Exemple d'utilisation
agy Lance la TUI interactive dans l'espace de travail actif agy
agy -p "<prompt>" Exécution non interactive (headless), affiche sur stdout et quitte agy -p "Summarize the last 5 commits"
agy -i "<prompt>" Lance une session interactive pré-remplie avec un prompt initial agy -i "Refactor auth middleware under src/auth"
agy -c, --continue Reprend la session de conversation la plus récente agy -c
agy --conversation <id> Charge une conversation historique spécifique par son identifiant agy --conversation 42a506e6-...
--mode <mode> Définit le mode de permission d'exécution :
default · accept-edits · auto (approbation auto en sandbox) · plan		 agy --mode accept-edits
--model <model> Remplace le modèle actif pour cette session agy --model gemini-3.8-flash
--effort <level> Règle l'effort de raisonnement (low à max, selon le modèle) agy --effort high
--agent <agent> Attache un profil d'agent personnalisé au démarrage agy --agent reviewer
--add-dir <path> Accorde au contexte d'espace de travail l'accès à un dossier supplémentaire (répétable) agy --add-dir ../shared-types
agy models / agy agents Liste les modèles disponibles ou les agents personnalisés configurés agy models
agy plugin <subcmd> Gère les plugins : install · list · validate --strict · import gemini agy plugin validate --strict ./my-plugin

2. Commandes slash interactives de la TUI

Saisissez / dans agy pour invoquer et auto-compléter les commandes intégrées :

2.1 Contrôle général, session et historique

Commande Fonction Remarques et usage
? / /help Liste toutes les commandes slash et raccourcis disponibles Référence rapide en cours de session
/config / /settings Ouvre l'écran interactif des paramètres en plein écran Modifie préférences, thèmes et permissions (settings.json)
/clear Vide le tampon de prompt actif et démarre une session vierge Bascule proprement vers une tâche distincte
/compact Compresse et résume l'historique de conversation Récupère de la marge contextuelle lors des longues sessions
/resume Ouvre le sélecteur de conversations pour restaurer une session Poursuit des workflows interrompus
/rewind / /undo Recule tour par tour dans l'historique de conversation Annule des tours ou orientations erronés
/fork Crée une branche de la conversation au point de contrôle actuel Explore des branches parallèles sans risque
/exit / /quit Quitte la session agy CLI Ou appuyez sur Ctrl + D Ctrl + D

2.2 Modèles, workflows, agents et extensions

Commande Fonction Remarques et usage
/model Change le modèle d'IA actif en cours de session Équilibre vitesse/coût et puissance de raisonnement
/effort Inspecte ou règle l'effort de raisonnement (low à max) Remarque : agy -p "/effort" renvoie une sortie JSON en lecture seule
/plan Génère un plan étape par étape avant toute édition de fichier Garde-fou avant de grands changements architecturaux
/goal S'exécute de manière autonome jusqu'à complétion sans pause Adapté aux tâches au long cours
/grill-me Mène un entretien interactif sur les exigences avant de coder Clarifie les cas limites et critères d'acceptation en amont
/agent Change de profil ou invoque un sous-agent/agent personnalisé Charge les définitions depuis .agents/agents/
/worktree Crée ou gère des répertoires Git worktree isolés Travaille sur des branches parallèles sans polluer l'arbre principal
/mcp Inspecte l'état MCP en direct, les logs et recharge la config Dépanne les serveurs MCP locaux ou distants
/plugin Parcourt, active, désactive ou inspecte les plugins du Marketplace Gère skills, règles, hooks et serveurs MCP groupés
/voice Active ou désactive la dictée vocale Raccourci équivalent : F5

3. Raccourcis clavier terminal et syntaxe de saisie

Raccourci / Syntaxe Action Effet et scénario
@<path> Auto-complétion des chemins Injecte des chemins précis de fichiers ou répertoires dans le contexte
!<command> Exécution terminal en ligne Préfixez avec ! pour lancer directement une commande shell (ex. !npm run build)
Ctrl + G Ouvrir l'éditeur externe Rédige des prompts longs ou multilignes dans votre éditeur par défaut (Vim, VS Code)
Esc Esc Effacer la zone de saisie Efface la saisie en attente lorsqu'aucun flux n'est actif
F5 Basculer la dictée vocale Équivalent à /voice
Ctrl + D Ctrl + D Quitter la session Double appui sur Ctrl + D pour quitter proprement

4. Hiérarchie de configuration et mcp_config.json

4.1 Carte des répertoires globaux vs espace de travail

Couche Portée globale (tous espaces de travail) Portée espace de travail (local au projet) Rôle
Paramètres CLI ~/.gemini/antigravity-cli/settings.json — Préférences CLI, thème, éditeur et permissions par défaut
Raccourcis clavier ~/.gemini/antigravity-cli/keybindings.json — Mappages clavier personnalisés pour le terminal
Instructions projet ~/.gemini/AGENTS.md ou GEMINI.md ./AGENTS.md ou ./GEMINI.md Conventions durables du dépôt, commandes build/test, persona
Règles permanentes ~/.gemini/config/rules/*.md .agents/rules/*.md Contraintes d'arrière-plan injectées automatiquement au contexte
Agent Skills ~/.gemini/config/skills/<name>/SKILL.md .agents/skills/<name>/SKILL.md Modules Agent Skills avec scripts et ressources
Configuration MCP ~/.gemini/config/mcp_config.json .agents/mcp_config.json Définitions de serveurs MCP locaux stdio et distants HTTP

⚠️ Schéma incompatible pour MCP distant (serverUrl) : Dans mcp_config.json, les serveurs MCP HTTP distants doivent utiliser serverUrl au lieu des anciennes clés url ou httpUrl — l'usage de url entraîne des échecs de connexion silencieux.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Migration depuis l'ancien Gemini CLI vers agy

L'offre gratuite grand public et les requêtes Google AI Pro/Ultra sur Gemini CLI ont pris fin le 18 juin 2026 (ne laissant que Gemini Code Assist entreprise et les workflows facturés par clé API). Correspondances clés pour migrer vers agy :

Composant Ancien Gemini CLI Antigravity CLI (agy) Action de migration
Moteur et binaire TypeScript open-source (gemini) CLI multi-agent en Go (agy) Basculez vos appels vers agy ; l'intégration auto démarre au lancement
Extensions Extensions Gemini CLI Plugins natifs Antigravity Exécutez agy plugin import gemini pour convertir et importer
Fichiers d'instructions GEMINI.md GEMINI.md et AGENTS.md Entièrement compatible — votre GEMINI.md actuel fonctionne tel quel
Chemin local des skills .gemini/skills/ .agents/skills/ Déplacez les dossiers vers .agents/skills/<name>/SKILL.md
Anciens workflows .agents/workflows/ Migrés vers Agent Skills Convertissez les workflows mono-fichiers vers .agents/skills/ (/migrate-workflows)
Config et clés MCP Intégrés dans settings.json via url mcp_config.json dédié utilisant serverUrl Extrayez les blocs MCP vers mcp_config.json et renommez url en serverUrl

Sujets associés

#antigravity-cli#ai-coding#ai-agent#cli#cheat-sheet