Antigravity CLI (agy) : paramètres et autoriser toutes les permissions

La CLI Google Antigravity (agy) exécute l'agent de programmation d'Antigravity dans votre terminal sur macOS, Linux, Googlebook et Windows. Vous la configurez avec des commandes slash telles que /config et /permissions ou dans ~/.gemini/antigravity-cli/settings.json. Pour autoriser toutes les permissions sans confirmation, lancez agy --dangerously-skip-permissions, définissez "toolPermission": "always-proceed", ou ajoutez des règles allow génériques telles que command(*).

Installer et lancer la CLI Antigravity (agy)

Installez la CLI Antigravity (agy, v1.2+) avec l'installateur correspondant à votre système d'exploitation.

Sur macOS, Linux et Googlebook, exécutez :

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

L'installateur place par défaut le binaire dans ~/.local/bin/agy.

Sous Windows dans PowerShell, exécutez :

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

Sous Windows dans l'invite de commandes (CMD), exécutez :

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

Les deux installateurs Windows placent par défaut le binaire dans C:\Users\<username>\AppData\Local\agy\bin. Ouvrez un terminal et vérifiez l'installation :

agy --version

Le premier lancement vous invite à configurer trois éléments :

• Thème de couleurs : choisissez Dark, Solarized Dark, Solarized Light ou le thème par défaut de votre terminal.
• Mode de rendu : choisissez Alt-Screen mode pour un tampon plein écran ou Inline mode pour afficher la sortie dans l'historique du terminal.
• Confiance accordée à l'espace de travail : confirmez que vous faites confiance au répertoire du dépôt avant que l'agent ne commence l'indexation des fichiers.

Commandes CLI courantes, drapeaux de démarrage et commandes slash

Exécutez agy dans le répertoire d'un projet pour démarrer une session interactive. Les drapeaux modifient son démarrage :

Configurer la CLI Antigravity avec /config et settings.json

La CLI conserve vos préférences persistantes dans ~/.gemini/antigravity-cli/settings.json, et toute clé omise utilise sa valeur par défaut.

{
  "agentMode": "accept-edits",
  "toolPermission": "strict",
  "notifications": true
}

Fonctionnement du fichier de configuration :

• Validation du schéma : ajoutez "$schema": "https://antigravity.google/schemas/v1/settings.json" en haut du fichier pour activer l'autocomplétion et la validation dans des éditeurs tels que VS Code.
• Panneau de configuration : exécutez /config ou son alias /settings pour ouvrir l'éditeur de paramètres, modifiez les options avec les touches fléchées, puis appuyez sur Esc pour fermer.
• Télémétrie du compte : l'option Enable Telemetry dans /config n'a pas de clé dans settings.json car la CLI enregistre ce choix au niveau de votre compte.

D'autres paramètres sont enregistrés dans leurs propres fichiers :

• Raccourcis clavier : exécutez /keybindings pour ouvrir l'éditeur de raccourcis clavier et personnaliser les raccourcis dans ~/.gemini/antigravity-cli/keybindings.json.
• Gestionnaire d'autorisations : exécutez /permissions pour afficher, ajouter, modifier et supprimer des règles action(target) dans les portées Project, Shared et Global.
• MCP et plugins : exécutez /mcp pour ouvrir le gestionnaire de serveurs Model Context Protocol, ou /plugin pour gérer les plugins.
• Hooks de script : exécutez /hooks dans la zone de saisie pour parcourir les hooks de script actifs avant exécution et après formatage.

Options principales de settings.json

Modes d'exécution et autorisations des outils

Deux paramètres déterminent la fréquence à laquelle l'agent s'interrompt pour vous consulter : le mode d'exécution et toolPermission. Les règles de refus bloquent toujours une action quel que soit le mode.

Définissez le mode avec agentMode dans settings.json, pour une seule session avec --mode, ou faites défiler les modes avec Shift + Tab :

• default (en laissant agentMode non défini) : vous demande de relire les diffs avant toute modification de fichier.
• accept-edits : approuve automatiquement les modifications et créations de fichiers dans l'espace de travail.
• auto : approuve les modifications dans l'espace de travail, exécute par défaut les commandes dans le bac à sable du terminal et lance les commandes sûres et réversibles sans confirmation.
• Prérequis du mode auto : nécessite la CLI v1.3.5+ sur macOS et Linux ou v1.4.4+ sous Windows, le bac à sable du terminal et un compte personnel.
• plan : ajoute /plan pour que l'agent analyse la base de code et élabore un plan avant toute modification.

Le paramètre toolPermission détermine quand l'agent demande une confirmation avant d'exécuter un outil :

• request-review (par défaut) : demande une confirmation avant d'exécuter des outils d'écriture, bash, web ou MCP.
• proceed-in-sandbox : exécute les commandes de terminal sans confirmation lorsque le Sandbox Mode est activé et que la commande tourne dans le bac à sable du terminal.
• strict : demande une confirmation avant chaque action d'outil, y compris la lecture de fichiers, même si une règle d'autorisation correspond, et prévaut sur le mode auto.
• always-proceed : exécute les commandes, requêtes web et outils MCP sans confirmation sauf si une règle ask ou deny correspond, en prévalant sur le mode auto.

Comment autoriser toutes les permissions et commandes dans agy

Il existe plusieurs façons d'éviter les confirmations manuelles :

• Ignorer toutes les demandes d'autorisation pour une session : lancez agy --dangerously-skip-permissions pour approuver automatiquement toutes les demandes d'autorisation d'outils.
• Définir always-proceed : définissez "toolPermission": "always-proceed" dans settings.json afin que les commandes, requêtes web et outils MCP s'exécutent sauf si une règle ask ou deny correspond.
• Ignorer aussi les revues de modifications et d'artefacts : ajoutez "agentMode": "accept-edits" et "artifactReviewPolicy": "always-proceed" dans settings.json :

{
  "agentMode": "accept-edits",
  "toolPermission": "always-proceed",
  "artifactReviewPolicy": "always-proceed"
}

• Autoriser toutes les commandes avec une règle générique : ajoutez command(*) à la liste allow dans settings.json ou via /permissions, sans l'inclure dans ask ni deny.
• Utiliser le mode auto : lancez agy --mode=auto ou définissez "agentMode": "auto" pour que les modifications de l'espace de travail et les commandes sûres et réversibles s'exécutent sans confirmation.
• Utiliser Turbo dans l'application Antigravity : dans l'application de bureau, choisissez Turbo sous Settings > General > Global Permissions > Permission Preset pour désactiver le bac à sable et autoriser toutes les actions.

Règles d'autorisation : allow, ask et deny

Les règles emploient la syntaxe action(target) dans les listes allow, ask et deny sous permissions dans settings.json. Ces listes résident dans votre fichier de configuration global. En cas de conflit, l'ordre d'évaluation est strict : Deny prévaut, puis Ask, puis Allow. Ainsi, avec command(*) dans ask et command(git) dans allow, chaque commande demande tout de même une confirmation.

Fonctionnement du filtrage des règles :

• Caractères génériques globaux : * correspond à toutes les cibles d'une action, comme read_file(*), command(*) ou mcp(*).
• Préfixes de commande et expressions régulières : les règles command comparent par défaut les préfixes littéralement mot à mot, ou évaluent des expressions régulières lorsque la cible commence par regex:.
• Règles implicites : autoriser write_file sur un chemin autorise également read_file sur ce chemin, et refuser read_file sur un chemin bloque également write_file.
• Chemins Windows : les lettres de lecteur telles que C: sont retirées et les barres obliques inverses deviennent des barres obliques avant la vérification des règles.
• Correspondance des commandes sous Windows : dans PowerShell ou l'invite de commandes, les commandes qui ne peuvent pas être découpées proprement en mots nécessitent une correspondance exacte ou une règle regex:, telle que command(regex:git .*).
• Modification lors de la demande : avant de confirmer Allow sur une carte de demande pour un fichier, une URL ou un outil MCP, vous pouvez modifier la chaîne cible afin d'élargir sa portée pour le tour en cours.

{
  "permissions": {
    "allow": [
      "command(git)",
      "command(regex:npm run (build|lint|test))",
      "read_file(/var/log/app)",
      "write_file(src/)",
      "read_url(google.com)",
      "mcp(linter/*)"
    ],
    "deny": [
      "command(rm -rf)",
      "command(regex:curl .*)",
      "command(sudo)",
      "write_file(.git/)",
      "write_file(/home/user/.ssh)"
    ],
    "ask": ["command(*)", "execute_url(aws.amazon.com)", "mcp(sql/execute_mutation)"]
  }
}

Gérer les règles de manière interactive avec /permissions

Saisissez /permissions dans la zone de prompt et appuyez sur Enter pour ouvrir le panneau du gestionnaire d'autorisations :

• Sélecteur de portée : utilisez les touches fléchées ou J et K pour choisir Project, Shared ou Global, puis appuyez sur Enter.
• Affichage des règles : basculez entre les onglets allowlist, denylist et asklist avec les flèches gauche et droite ou Tab.
• Ajouter une règle : appuyez sur A, saisissez une règle au format action(target) telle que command(git), puis appuyez sur Enter pour la valider et l'enregistrer.
• Modifier ou supprimer une règle : mettez une règle en surbrillance et appuyez sur E ou Ctrl + G pour la modifier, ou sur D ou Backspace pour la supprimer.

Notifications, confirmations d'outils et raccourcis clavier

Le paramètre notifications est désactivé par défaut. Activez-le et la CLI fait retentir le signal sonore du terminal tout en affichant une notification sur le bureau dès que l'agent a besoin d'une approbation ou d'une réponse, ou lorsqu'il termine son tour.

En mode par défaut, la CLI marque une pause avant de modifier des fichiers ou d'exécuter des commandes. Ces touches permettent de répondre à ses demandes :

Pour gérer les sous-agents en arrière-plan avec /agents, basculer vers les sous-agents en attente et les approuver avec Alt+J et Ctrl+K, et animer des équipes multi-agents avec /teamwork, consultez Google Antigravity multi-agent: run parallel coding agents.

Si vous utilisez également l'éditeur autonome, consultez Google Antigravity IDE: editor, agents and permissions pour découvrir comment il partage les hooks globaux et configure le mode Strict, le bac à sable de terminal et la revue d'artefacts.

Pour connecter des bases de données, de la documentation et des API externes avec /mcp ou mcp_config.json, consultez Google Antigravity MCP servers: set up and manage tools.

Pour installer la CLI dans PowerShell ou l'invite de commandes, configurer votre PATH sous Windows et activer le bac à sable AppContainer, consultez Google Antigravity on Windows: install, CLI and setup.

Suivre les sessions Antigravity sur un pavé ou un téléphone avec Orbtile

Orbtile affiche vos agents de programmation sur un Logitech MX Creative Keypad, ou sur un iPhone (iOS 17+) ou un téléphone Android (Android 8.0+) exécutant Orbtile Mobile. Il fonctionne sur un ordinateur équipé de macOS 14.0 Sonoma ou ultérieur sur Apple silicon, ou de Windows 11 (x64).

• Application de bureau Antigravity : Orbtile suit les conversations de l'application de bureau Antigravity et attribue à chacune une touche avec son titre, son état et le texte de sa réponse en direct.
• Questions en attente au premier plan : une conversation en attente d'une question passe au premier plan et, depuis Orbtile 0.3.4, utilise la couleur d'alerte terracotta partagée.
• Répondre sur les touches : vous pouvez répondre depuis le pavé à un maximum de quatre questions à options numérotées, comportant chacune de deux à quatre choix.
• Conservés sur votre ordinateur : les demandes d'autorisation et les réponses rédigées restent sur votre ordinateur.
• CLI et IDE Antigravity : les sessions de la CLI et de l'IDE n'apparaissent pas automatiquement, mais un script de hook CLI peut signaler chaque session à l'Adapter API locale d'Orbtile.
• Activer l'Adapter API : dans Orbtile, ouvrez Settings > Agents, choisissez Build your own, activez Let your own tools show sessions, puis autorisez votre adaptateur.
• Tous les agents sur un seul pavé : le même pavé ou téléphone affiche également les sessions Claude Code, Codex, ZCode et Kimi Code, ainsi que les sessions distantes via SSH.

Consultez Notifications Antigravity : savoir quand un agent attend votre réponse et Show any script or agent on a keypad with the Orbtile Adapter API.