Antigravity CLI (agy) op een server

Sinds 18 juni 2026 bedient Gemini CLI geen persoonlijke accounts met de gratis laag, Google AI Pro of Ultra meer. De aankondiging van Google verwijst die gebruikers naar de Antigravity CLI, agy. Op een server vragen drie dingen aandacht: inloggen zonder browser, kiezen tussen Google-login en een API-sleutel, en weten hoe agy met toestemmingen omgaat als er niemand achter de terminal zit. Hier staan ze op volgorde.

agy installeren

Op Linux of macOS, als je gewone gebruiker (niet 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

Volgens de officiële installatiepagina komt de binary in ~/.local/bin/agy en worden macOS, Linux en Windows ondersteund. De installer haalt een build per platform op, met Linux-builds voor zowel amd64 als arm64, dus een ARM-VPS is geen probleem. Zet de PATH-regel in ~/.bashrc of ~/.profile, zodat nieuwe shells en tmux-vensters hem oppikken.

Eén gewoonte specifiek voor servers: agy werkt zichzelf op de achtergrond bij. Op een laptop is dat handig. Op een machine die je laat doordraaien, betekent het dat de versie onder een lange sessie kan veranderen. Maude pint de versie die het installeert en zet dit uit met AGY_CLI_DISABLE_AUTO_UPDATE=1. Wil je dezelfde voorspelbaarheid, exporteer die variabele dan in de shell of unit die agy start.

Inloggen via SSH

Start agy in een SSH-sessie en kies inloggen met Google. Op een laptop zou het een browser openen. Via SSH herkent het de externe sessie en toont het in plaats daarvan een autorisatie-URL. Daarna:

1. Kopieer de URL en open hem op je telefoon of laptop.
2. Log in met het Google-account dat je voor Antigravity gebruikt.
3. Kopieer de code die de pagina je geeft en plak hem terug in de terminal.

Inloggegevens worden opgeslagen in de sleutelhanger van het besturingssysteem, op Linux de Secret Service. Een kale VPS heeft geen desktopsessie om een sleutelhanger te ontgrendelen. Een GitHub-issue over agy 1.0.0 meldt precies daardoor een inloglus op headless Linux, plus een tijdzonebug in de terugval naar een bestand. De workaround van de melder was GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. We hebben niet bevestigd of huidige versies dat nog nodig hebben. Vraagt agy je bij elke start opnieuw in te loggen, kijk dan eerst naar dat issue. Gebruik anders de API-sleutelmodus.

Om uit te loggen en het opgeslagen profiel te wissen, voer je /logout uit in agy.

API-sleutelmodus voor headless

Voor CI, een gedeelde machine of elke server waar je liever geen Google-sessie bewaart, draai je agy op een Gemini-API-sleutel. De installatiedocumentatie geeft twee stappen. Stel eerst de modelprovider in ~/.gemini/antigravity-cli/settings.json in. Bestaat het bestand al, voeg het er dan aan toe:

{
  "modelProvider": "gemini"
}

Maak daarna de sleutel beschikbaar voor het proces:

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

Zo sla je het inloggen met een account volledig over. Gebruik wordt per token gefactureerd volgens de prijzen van de Gemini API, in plaats van mee te tellen voor een Google AI-abonnement. Houd de sleutel uit je shellgeschiedenis en uit de repository waarin de agent werkt.

Toestemmingen als niemand kijkt

Dit servergedrag verrast mensen het meest. In onze tests met agy 1.2.14 geldt: headless runs (agy -p …, of de stream-json-modus) kunnen niet stoppen en vragen voordat een tool draait. Een commando of schrijfactie op een bestand dat toestemming nodig heeft, wordt geweigerd, en het resultaat van de beurt vermeldt het als geweigerd. Je hebt drie manieren om werk door te laten:

• Sta toe-regels. agy leest ze uit permissions.allow in ~/.gemini/antigravity-cli/settings.json. Regels zien eruit als "command(npm test)", "write_file(src/app.ts)" of "command(*)". Ze worden bij het starten gelezen.
• Modi. --mode accept-edits keurt bestandswijzigingen automatisch goed, al worden commando's nog steeds geweigerd. --mode plan plant zonder iets te doen.
• Helemaal geen controles. --dangerously-skip-permissions, voor een wegwerpmachine. Lees eerst agents veilig met volledige toestemmingen draaien voordat je ernaar grijpt.

Interactieve agy in een terminal, en Remote Control (hieronder), kunnen wel pauzeren en vragen. Deze beperking geldt dus specifiek voor gescript, headless gebruik.

Je Gemini CLI-config meenemen

De migratiegids behandelt dit. De korte versie voor een server waarop al Gemini CLI stond:

• De eerste start biedt migratie aan. Vindt agy bestaande Gemini CLI-configuratie, dan toont het een checklist met extensies en globale instellingen om om te zetten.
• Extensies worden plugins. Voer op elk moment agy plugin import gemini uit om Gemini-extensies om te zetten naar Antigravity-plugins.
• Contextbestanden werken zoals ze zijn. GEMINI.md (in de workspace en ~/.gemini/GEMINI.md) en AGENTS.md worden zonder wijzigingen gelezen.
• MCP-servers vragen een kleine aanpassing. Globale servers staan in ~/.gemini/config/mcp_config.json, die per workspace in .agents/mcp_config.json. Hernoem de oude sleutels url/httpUrl naar serverUrl.
• Skills verhuizen. Workspace-skills gaan van .gemini/skills/ naar .agents/skills/, en globale naar ~/.gemini/antigravity-cli/skills/. Die moet je zelf verplaatsen.

Google zegt dat er nog geen volledige functiepariteit is, en de migratiegids merkt op dat sommige eigen thema's en visuele aanpassingen niet meekomen. Hangt een workflow af van een specifieke extensie, test die dan na het importeren voordat je de oude opzet verwijdert.

Remote Control-daemon vs Maude

Google levert een officiële manier om agy vanaf een ander apparaat te bereiken. Volgens de Remote Control-documentatie start je het op drie manieren:

• /remote-control in een lopende sessie. De tunnel stopt als die CLI-sessie stopt.
• agy --remote-control als je een sessie start. Ook deze tunnel stopt als de sessie stopt.
• De headless daemon: agy remote-control start --name my-vps, met agy remote-control status en agy remote-control stop. Die registreert een OS-dienst die op de achtergrond blijft draaien.

Je bestuurt het vanuit een webdashboard in elke browser, ingelogd met hetzelfde Google-account. Volgens de documentatie kun je het dashboard op het beginscherm van je telefoon installeren om pushmeldingen te krijgen, en kun je toestemmingsverzoeken beantwoorden vanuit de terminal of de externe UI. Er staat ook dat een functievlag voor een account of organisatie het kan blokkeren.

Is Antigravity de enige agent die je gebruikt en staat de functievlag voor je account aan, dan is de officiële daemon de voor de hand liggende eerste keuze. Hij is gratis en kan vragen voordat hij iets doet.

Draai het vanaf je telefoon

Wil je agy op een server naast andere agents en aangestuurd vanuit een native app, dan is Maude een optie. Voeg de server toe, en de app installeert agy in een geteste versie en logt je in vanaf de telefoon. Je kunt Google-login met een geplakte code gebruiken of een Gemini-API-sleutel. Om eerlijk te zijn over Antigravity in Maude: omdat Maude agy headless aanstuurt, kan het niet stoppen en vragen voordat een tool draait. Maude toont je de geweigerde actie, en als je goedkeurt, voegt het een toestaan-regel toe en probeert het opnieuw. De agentpagina van Antigravity heeft de details. De wijziging bij Gemini CLI zelf, en naar welke opties mensen overstapten, staat in ons artikel over het einde van Gemini CLI.

Veelgestelde vragen

Wat is er veranderd

• 1 oktober 2026 — Eerste publicatie. Installatie, authenticatie, migratie en Remote Control gecontroleerd aan de hand van de documentatie op antigravity.google; het toestemmingsgedrag in headless modus uit onze eigen tests met agy 1.2.14.