Apidog CLI in Antigravity nutzen

Antigravity arbeitet in einer Schleife: Der Agent bearbeitet Dateien, führt Terminalbefehle aus, liest die Ausgabe und entscheidet über den nächsten Schritt. Ihre API-Tests sollten Teil derselben Schleife sein. Mit der Apidog CLI führt Antigravity Testszenarien aus dem Terminal aus, prüft den Exit-Code und kann bei Fehlern gezielt nachbessern.

Apidog noch heute ausprobieren

Die Apidog CLI ist das npm-Paket apidog-cli. Sie führt Testszenarien, die Sie in Apidog erstellt haben, direkt per Shell aus. Damit behandelt Antigravity API-Tests wie Unit-Tests:

1. Befehl ausführen
2. Exit-Code prüfen
3. Fehlerbericht lesen
4. Code korrigieren und erneut testen

Installieren und authentifizieren Sie die CLI zuerst. Die Anleitung Apidog CLI mit einem KI-Codierungsagenten installieren beschreibt npm-Installation, Anmeldung und den ersten Testlauf. Für die folgenden Schritte sollte dieser Befehl eine Versionsnummer ausgeben:

apidog --version

Was mit Antigravity gemeint ist

Antigravity ist Googles agentische Entwicklungsplattform auf Basis von Gemini 3. Der Agent plant Aufgaben, bearbeitet Dateien im Repository und führt Shell-Befehle in seinem eigenen Terminal aus.

Entscheidend für diesen Workflow: Antigravity kann Projektregeln aus Dateien laden. Statt dem Agenten in jedem Chat erneut zu sagen, wie API-Tests laufen, hinterlegen Sie den Befehl dauerhaft im Repository.

Eine allgemeine Einführung finden Sie unter Was Google Antigravity ist und wie man es benutzt.

Schritt 1: Eine dauerhafte Regel für API-Tests anlegen

Antigravity erkennt das Verzeichnis .agents/ im Root des Arbeitsbereichs. Legen Sie Ihre Regeldatei hier ab:

.agents/rules/apidog.md

Googles Codelab zum Erstellen autonomer Entwickler-Pipelines in Antigravity beschreibt diesen Mechanismus.

Wenn Ihr Repository bereits eine AGENTS.md im Root enthält, können Sie den folgenden Block stattdessen dort ergänzen. Diese Datei kann auch von anderen Agenten genutzt werden, etwa von Codex mit der Apidog CLI.

Fügen Sie diese Regel ein und ersetzen Sie später die Platzhalter durch Ihre echten IDs:

## API-Tests mit der Apidog CLI

- Für API-Tests immer das Apidog-Szenario per CLI ausführen, nicht die GUI verwenden.
- Befehl: `apidog run -t <scenario_id> -e <env_id> -r cli`
- Exit-Code `0` bedeutet: Alle Assertions sind erfolgreich.
- Ein Exit-Code ungleich `0` bedeutet: Test fehlgeschlagen. Bericht lesen, Code korrigieren und Test erneut ausführen.
- Der Rechner ist bereits über `apidog login` authentifiziert.
- Niemals `--access-token` hinzufügen und keine Tokens in dieser Datei speichern.

Diese Datei ist wichtiger als eine Chat-Anweisung: Chat-Kontext kann nach einer Sitzung verschwinden, eine versionierte Regeldatei bleibt für alle Teammitglieder und zukünftigen Agent-Läufe erhalten.

Schritt 2: Den exakten apidog run-Befehl kopieren

Raten Sie Szenario- und Umgebungs-IDs nicht.

1. Öffnen Sie Ihr Testszenario in Apidog.
2. Wechseln Sie zum Tab CI/CD.
3. Kopieren Sie den generierten Befehl.
4. Ersetzen Sie damit den Platzhalter in .agents/rules/apidog.md.

Ein typischer Befehl sieht so aus:

apidog run -t 123456 -e 789012 -r cli

Dabei gilt:

• -t: ID des Testszenarios
• -e: ID der Umgebung
• -r cli: Ausgabe des Berichts direkt im Terminal

Die vollständige Beschreibung der Optionen finden Sie in der Referenz für apidog run.

Schritt 3: Den Agenten den Test ausführen lassen

Starten Sie nach dem Anlegen oder Ändern der Regeldatei eine neue Aufgabe in Antigravity. Der Agent lädt die Regeln beim Start.

Sie können ihn nach einer API-Änderung direkt auffordern:

Führe das Apidog-Testszenario aus und nenne mir den Exit-Code.

Der Agent sollte dann den in Ihrer Regeldatei hinterlegten Befehl ausführen:

apidog run -t 123456 -e 789012 -r cli

Ob Antigravity den Befehl ohne Rückfrage ausführt, hängt von Ihren Berechtigungseinstellungen ab. Wenn Antigravity eine Bestätigung verlangt, prüfen und genehmigen Sie den Befehl bewusst. Googles Antigravity-Einstiegs-Codelab erläutert diese Sicherheitsoptionen.

Für API-Tests gegen eine Staging-Umgebung ist ein schreibgeschützter Testlauf in der Regel ein klar abgegrenzter, überprüfbarer Terminalbefehl.

Schritt 4: CLI-Bericht und Exit-Code auswerten

Mit -r cli erhält der Agent die Testergebnisse direkt im Terminal. Bei einem Fehler enthält die Ausgabe typischerweise:

• ausgeführte Requests
• Assertions
• erwartete und tatsächliche Werte
• fehlgeschlagene Statuscodes oder Felder

Der Exit-Code ist das verlässliche Signal:

0       Alle Assertions bestanden
!= 0    Mindestens eine Assertion fehlgeschlagen

Wenn Sie zusätzlich einen teilbaren HTML-Bericht benötigen, kombinieren Sie beide Reporter:

apidog run -t 123456 -e 789012 -r cli,html

Der HTML-Reporter schreibt eine eigenständige Datei nach:

./apidog-reports

Behalten Sie cli bei, damit Antigravity die Ausgabe weiterhin direkt lesen und auf Fehler reagieren kann.

Weitere Reporter, darunter JUnit für CI-Dashboards, finden Sie im vollständigen Apidog CLI-Leitfaden und in der Anleitung zum Lesen von Apidog CLI-Testberichten.

Die API-Testschleife in Antigravity integrieren

Sobald die Regeldatei vorhanden ist, kann der Agent API-Tests in seine bestehende Bearbeiten-Testen-Korrigieren-Schleife aufnehmen.

Ein praktischer Ablauf sieht so aus:

1. Der Agent ändert einen API-Handler.
2. Er führt apidog run gegen die konfigurierte Umgebung aus.
3. Er prüft den Exit-Code.
4. Bei Exit-Code 0 fährt er mit der Aufgabe fort.
5. Bei einem Fehler liest er die fehlgeschlagene Assertion.
6. Er korrigiert den betroffenen Code.
7. Er führt das Szenario erneut aus.

So wird ein API-Test nicht erst nach einem Deployment manuell ausgeführt, sondern während der Agent noch an der Änderung arbeitet.

Das Muster ist einfach: Der Agent delegiert die Prüfung an das Testszenario und verifiziert das Ergebnis über die CLI-Ausgabe und den Exit-Code. Sie erstellen und pflegen die Szenarien weiterhin visuell in Apidog.

Weitere Hintergründe dazu finden Sie unter KI-Agenten für API-Tests verwenden und im Apidog AI-Test-Harness.

Prüfen, ob Antigravity den Test wirklich ausgeführt hat

Verlassen Sie sich nicht ausschließlich auf die Zusammenfassung des Agenten. Prüfen Sie diese drei Punkte.

1. Wurde der Befehl tatsächlich ausgeführt?

Suchen Sie im Antigravity-Terminal nach der konkreten Befehlszeile:

apidog run ...

Direkt darunter sollte die rohe CLI-Ausgabe stehen. Wenn der Agent behauptet, der Test sei gelaufen, aber kein apidog run sichtbar ist, lassen Sie ihn den Befehl erneut ausführen und die Ausgabe anzeigen.

2. Welchen Exit-Code hatte der Lauf?

Fragen Sie explizit:

Welchen Exit-Code hatte der apidog-run-Befehl?

Der Exit-Code ist verbindlich. Wenn die textliche Zusammenfassung „Tests bestanden“ sagt, der Prozess aber mit einem Wert ungleich 0 endet, ist der Test fehlgeschlagen.

3. Wurden die korrekten IDs verwendet?

Ein Fehler wie „Szenario nicht gefunden“ deutet oft darauf hin, dass eine ID falsch ist oder vom Agenten geraten wurde.

Vergleichen Sie in diesem Fall:

• -t in der Regeldatei
• -e in der Regeldatei
• den im Apidog-CI/CD-Tab generierten Befehl

Der von Apidog generierte Befehl ist die maßgebliche Quelle.

Optional: Den Apidog MCP-Server verbinden

Die CLI deckt das Ausführen und Bewerten von Tests ab. Wenn der Agent zusätzlich Ihre API-Spezifikation beim Schreiben von Code lesen soll, können Sie den Apidog MCP-Server anbinden.

Antigravity unterstützt das Model Context Protocol. Laut Googles Antigravity-Einstiegs-Codelab werden MCP-Server in dieser Datei konfiguriert:

$HOME/.gemini/config/mcp_config.json

Dort ergänzen Sie einen Eintrag im Objekt mcpServers mit:

• command
• args
• env

Aktualisieren Sie anschließend die MCP-Konfiguration in den Antigravity-Einstellungen.

Der Apidog MCP-Server stellt API-Spezifikationen über MCP bereit. Die Aufgabentrennung bleibt klar:

• Apidog CLI: führt Tests aus und liefert Exit-Code sowie Berichte.
• Apidog MCP-Server: gibt dem Agenten Zugriff auf die API-Spezifikation.

Häufige Einrichtungsfehler

Antigravity ignoriert die Regeldatei

Prüfen Sie:

.agents/rules/apidog.md

• Liegt die Datei im Root des aktuellen Arbeitsbereichs?
• Ist der Dateiname korrekt?
• Haben Sie nach der Änderung eine neue Aufgabe gestartet?

Der Agent muss die Regeln neu laden.

Der Agent fügt trotzdem --access-token hinzu

Wenn Sie sich bereits mit apidog login authentifiziert haben, braucht der Befehl kein Zugriffstoken.

Halten Sie diese Regel explizit fest:

Niemals `--access-token` hinzufügen und keine Tokens in dieser Datei speichern.

Details dazu finden Sie unter Apidog CLI-Authentifizierung.

Der Agent erfindet ein nicht vorhandenes Flag

Bei einer Meldung wie „unbekannte Option“ sollte der Agent nicht weiter raten. Lassen Sie ihn die für Ihre installierte Version gültigen Optionen anzeigen:

apidog run --help

Danach sollte er das Flag exakt aus dieser Ausgabe übernehmen.

Der Agent meldet Erfolg trotz fehlgeschlagenem Test

Bei Widersprüchen gilt immer:

Exit-Code vor Zusammenfassung

Ein Exit-Code ungleich 0 bedeutet, dass der Lauf nicht als bestanden gelten darf.

Fazit

Die Einrichtung besteht aus drei dauerhaften Schritten:

1. apidog-cli installieren und mit apidog login authentifizieren.
2. Den generierten apidog run-Befehl in .agents/rules/apidog.md oder AGENTS.md hinterlegen.
3. Antigravity den Exit-Code und die CLI-Ausgabe auswerten lassen.

Damit werden API-Tests Teil der Arbeitsroutine des Agenten. Fehlerhafte Endpunkte können auffallen, während der Agent noch am Code arbeitet, statt erst nach dem Deployment.

Erstellen Sie Ihre Szenarien weiterhin in Apidog, kopieren Sie den CI/CD-Befehl in Ihre Regeldatei und lassen Sie Antigravity ihn bei API-Änderungen ausführen. Für die Ausführung desselben Befehls in einer CI-Pipeline beschreibt Apidog CLI in GitHub Actions Geheimnisse, Reporter und Exit-Code-Gating.