Configurer Antigravity

Installer

L’image d’agent fournit agy dans les conteneurs locaux. Dans une sandbox cloud, Outpost l’installe s’il est absent, sauf si vous définissez bootstrap: false.

L’installateur prend en charge Linux amd64 et arm64 (glibc et musl) ainsi que macOS Intel et Apple Silicon. Les autres plateformes échouent.

Comparez la version installée à la version épinglée :

npx outpost doctor --agent antigravity --image outpost:dev
npx outpost doctor --agent antigravity --sandbox-provider local

• Version épingléeagentVersions.antigravity, téléchargée depuis les archives versionnées de Google.
• Contrôle SHA-512Chaque archive est vérifiée avant extraction ; une empreinte incorrecte interrompt l’installation.
• Pas de mise à jour automatiqueLes images, les exécutions et doctor définissent AGY_CLI_DISABLE_AUTO_UPDATE=true.

doctor avertit quand les versions diffèrent. Il ne vérifie ni l’empreinte du binaire ni la connexion.

Se connecter avec son compte

Lancez agy sur l’hôte et connectez-vous avec votre compte Google.

import { createAgent, createAntigravityHarness } from "@elie-laloum/outpost";

export const coder = createAgent({
  harness: createAntigravityHarness({ authentication: "account" }),
});

Outpost copie ~/.gemini/antigravity-cli/antigravity-oauth-token dans le répertoire personnel privé de la sandbox. Pour un jeton rangé ailleurs, passez { account: { file: "/path/to/token" } }. Voir Authentification.

Utiliser une clé d’API

Déclarez GEMINI_API_KEY. L’usage de l’API Gemini est facturé séparément des forfaits Google AI.

import { createAgent, createAntigravityHarness } from "@elie-laloum/outpost";

export const coder = createAgent({
  harness: createAntigravityHarness({
    authentication: "usage",
    variables: { GEMINI_API_KEY: process.env.GEMINI_API_KEY ?? "" },
  }),
});

Outpost écrit aussi ~/.gemini/antigravity-cli/settings.json dans le répertoire personnel de la sandbox pour sélectionner le fournisseur Gemini. { usage: { variable: "NAME" } } lit la clé dans une autre variable déclarée.

Fonctions disponibles

• ConversationsReprise dans la même session de sandbox avec sandbox.resume(id, options) ou resume() sur un résultat à chaud.
• Réparations de réponseUne réponse typée invalide est réparée dans cette même conversation.
• RéorientationLivrée en mode resumed : Outpost arrête agy, puis reprend la conversation avec votre texte.
• Serveurs MCPFusionnés dans ~/.gemini/config/mcp_config.json du répertoire personnel de l’agent.
• ConsommationJetons d’entrée, en cache et de sortie par tour ; les jetons de réflexion comptent en sortie.
• Modèle et modeLe model de l’agent devient --model ; mode passe --mode accept-edits ou plan.

Sans mode, les exécutions non interactives passent --dangerously-skip-permissions : c’est la sandbox qui borne ce que l’agent peut faire. Les terminaux interactifs conservent les demandes d’approbation de la CLI. Choisir un agent compare tous les agents.

Limites

• Les conversations ne sont pas capturées : elles disparaissent avec la sandbox. La reprise à froid et fork() sont refusés, et createAntigravityHarness() refuse un stockage conversations.
• Un modèle avec reasoning ou maxOutputTokens est refusé à la composition de l’agent.
• Les options MCP tools.include, startupTimeoutMs et oauth: "login" sont refusées.
• Le bootstrap réutilise un agy déjà présent dans le PATH sans vérifier sa version ni son empreinte.

API : createAntigravityHarness · AntigravitySettings · agentVersions.