ANTIGRAVITY - GOOGLE AGENTIC DEVELOPMENT PLATFORM
=================================================

Stand: 2026-01-23
Validiert: 2026-02-08 (Help-Forensik)

QUELLEN
-------
  Web-Recherche durchgefuehrt am 2026-01-23:
  - Google Codelabs: Getting Started with Google Antigravity
  - Google Developers Blog: Build with Google Antigravity
  - Google Blog: Gemini 3 for developers
  - GitHub Gist: Google Antigravity Prompts (Agent-Tools)
  - Medium: Tutorial Getting Started with Google Antigravity
  - Codecademy: How to Set Up and Use Google Antigravity
  - antigravity.google/docs (offizielle Dokumentation)

WAS IST ANTIGRAVITY?
--------------------
Antigravity ist Googles Agent-first Development Platform,
basierend auf VS Code. Anders als klassische IDEs mit
KI-Sidebar arbeitet Antigravity mit autonomen Agenten,
die Tasks selbststaendig planen, ausfuehren und verifizieren.

Kernkonzept: "Du bist der Architekt, die Agenten bauen."

INSTALLATION
------------
  Pfad:       C:\Users\User\AppData\Local\Programs\Antigravity\
  CLI:        antigravity.cmd (oder 'agy' nach Setup)
  Config:     C:\Users\User\.antigravity\
  Gemini:     C:\Users\User\.gemini\antigravity\
  Version:    1.104.0+ (Stand: 2026-01-23)
  Download:   https:/antigravity.google/download

ZWEI INTERFACES
---------------
  1. Editor View (Cmd+E toggle)
     - Klassische IDE mit Tab-Completion
     - Inline-Commands (Cmd+I)
     - Syntax-Highlighting, Debugging

  2. Agent Manager View (Cmd+E toggle)
     - Task-Delegation an autonome Agenten
     - Parallele Task-Ausfuehrung (5+ Agenten gleichzeitig)
     - Artifacts: Task-Listen, Plaene, Screenshots, Recordings

CLI-BEFEHLE
-----------
  # Editor oeffnen
  antigravity [pfad]
  agy [pfad]                    # Alias (nach Setup)

  # Chat-Session (oeffnet immer GUI!)
  antigravity chat "Dein Prompt"
  antigravity chat -m ask "Frage stellen"
  antigravity chat -m edit "Code bearbeiten"
  antigravity chat -m agent "Agent-Modus"
  antigravity chat -a datei.py "Mit Datei-Kontext"
  antigravity chat --maximize   # Chat-Panel maximiert

  # MCP-Server
  antigravity --add-mcp '{"name":"name","command":"cmd","args":[]}'

  # Extensions
  antigravity --list-extensions
  antigravity --install-extension publisher.name

WICHTIG: Kein Headless-Modus! Chat oeffnet immer die GUI.

TASTENKUERZEL
-------------
  Cmd+L       Agent-Panel ein/ausblenden
  Cmd+I       Inline-Completion (Editor/Terminal)
  Cmd+E       Editor <-> Agent Manager wechseln
  Tab         Auto-Complete akzeptieren

ENTWICKLUNGSMODI
----------------
Bei Erststart oder in Settings waehlbar:

  Agent-driven (Autopilot)
    - Agent schreibt Code autonom
    - Fuehrt Tests selbst aus
    - Minimal User-Interaktion

  Review-driven (Empfohlen)
    - Agent fragt vor Aktionen um Erlaubnis
    - Gute Balance Kontrolle/Autonomie

  Agent-assisted
    - User bleibt in Kontrolle
    - Agent hilft bei sicheren Automationen

TERMINAL EXECUTION POLICIES
---------------------------
Steuert was der Agent im Terminal ausfuehren darf:

  Off
    - Keine Auto-Execution
    - Nur Allow-Liste wird ausgefuehrt
    - Alles andere braucht Genehmigung

  Auto (Empfohlen)
    - Agent entscheidet situativ
    - Fragt bei unsicheren Befehlen

  Turbo
    - Alles automatisch ausfuehren
    - Nur Deny-Liste wird blockiert
    - VORSICHT: Potenzielle Sicherheitsrisiken!

  Allow-Liste: Settings > Advanced > Allow List
  Deny-Liste:  Settings > Advanced > Deny List

AGENT-TOOLS (INTERN)
--------------------
Der Agent nutzt intern ~25 Tools:

  Dateisystem:
    view_file              Datei lesen (1-800 Zeilen)
    view_file_outline      Datei-Gliederung (Klassen, Funktionen)
    write_to_file          Neue Datei erstellen
    replace_file_content   Datei bearbeiten (einzelner Block)
    multi_replace_file_content  Mehrere Bloecke bearbeiten
    list_dir               Verzeichnisinhalt auflisten
    find_by_name           Dateisuche (fd-basiert, glob)

  Suche:
    codebase_search        Semantische Code-Suche
    grep_search            ripgrep-Suche (regex/literal)
    search_in_file         Suche innerhalb einer Datei
    search_web             Web-Suche

  Terminal:
    run_command            Shell-Befehl ausfuehren
    command_status         Befehl-Status abfragen
    send_command_input     Input an laufenden Befehl senden
    read_terminal          Terminal-Ausgabe lesen

  Browser:
    browser_subagent       Browser-Steuerung mit Recording
    read_url_content       Web-Inhalt fetchen (kein JS)

  MCP:
    list_resources         MCP-Ressourcen auflisten
    read_resource          MCP-Ressource lesen

  Sonstige:
    generate_image         KI-Bildgenerierung
    view_code_item         Code-Symbol anzeigen
    view_content_chunk     Dokument-Chunk laden

ARTIFACTS-SYSTEM
----------------
Agenten erstellen automatisch Artifacts:

  brain/{session-id}/
    task.md                Aufgaben-Checkliste (LESBAR!)
    implementation_plan.md Implementierungsplan
    walkthrough.md         Walkthrough/Erklaerung

  Weitere Artifacts:
    - Browser-Recordings (WebP-Videos)
    - Screenshots
    - Test-Reports
    - Code-Diffs

Artifacts ermoeglichen:
  - Nachvollziehbarkeit der Agent-Arbeit
  - Kommentare wie in Google Docs
  - Feedback ohne Agent-Unterbrechung

SKILLS-SYSTEM
-------------
Skills erweitern Agent-Faehigkeiten projektspezifisch:

  Global:    ~/.gemini/antigravity/skills/
  Workspace: <workspace>/.agent/skills/

  Format (SKILL.md):
    ---
    description: Kurzbeschreibung wann Skill aktiviert wird
    ---
    # Skill-Name
    Detaillierte Anweisungen...

Skills werden NUR geladen wenn relevant (Progressive Disclosure).
Vermeidet Context-Ueberladung und Token-Kosten.

WORKFLOWS
---------
Wiederverwendbare Prompt-Sequenzen:

  Pfad: .agent/workflows/*.md

  Format:
    ---
    description: Was dieser Workflow macht
    ---
    1. Erster Schritt
    2. Zweiter Schritt
    / turbo           <- Dieser Schritt auto-run
    3. Dritter Schritt

  Trigger: /workflow-name im Chat

  Annotationen:
    / turbo       Einzelnen Schritt auto-ausfuehren
    / turbo-all   ALLE Schritte auto-ausfuehren

RULES
-----
Globale Regeln fuer Agent-Verhalten:

  Pfad: .agent/rules/*.md

Beispiele:
  - Code-Style Guidelines
  - License-Header Anforderungen
  - Commit-Message Format
  - Projekt-spezifische Konventionen

MCP (MODEL CONTEXT PROTOCOL)
----------------------------
Antigravity unterstuetzt MCP-Server vollstaendig:

  Config: ~/.gemini/antigravity/mcp_config.json

  Beispiel:
    {
      "mcpServers": {
        "bach-mcp": {
          "command": "python",
          "args": ["C:/path/to/bach_mcp_server.py"]
        }
      }
    }

  CLI:
    antigravity --add-mcp '{"name":"bach","command":"python","args":[...]}'

MCP ermoeglicht:
  - Datenbankzugriff (PostgreSQL, SQLite)
  - API-Integrationen (GitHub, Slack)
  - Eigene Tools bereitstellen
  - Bidirektionale Kommunikation

DATENSTRUKTUR
-------------
  .antigravity\
    argv.json              Startparameter
    extensions/            Installierte Extensions
    extensions.json        Extension-Registry

  .gemini\antigravity\
    annotations/           Session-Metadaten (.pbtxt)
    brain/                 Task-Listen pro Session (LESBAR!)
    code_tracker/          Code-Aenderungsverfolgung
    context_state/         Kontext-Speicher
    conversations/         Chat-Verlaeufe (.pb, BINAER)
    implicit/              Implizites Memory (.pb)
    knowledge/             Wissensdatenbank
    playground/            Sandbox
    scratch/               Temporaer
    skills/                Globale Skills
    mcp_config.json        MCP-Server Config
    browserAllowlist.txt   Browser URL Allowlist

SICHERHEIT
----------
  Browser URL Allowlist
    Pfad: ~/.gemini/antigravity/browserAllowlist.txt
    Schuetzt vor Prompt-Injection auf Webseiten

  Terminal Allow/Deny Lists
    Steuert welche Befehle automatisch laufen duerfen

  Empfehlungen:
    - Review-driven Modus fuer sensible Projekte
    - Deny-Liste: rm -rf, curl (ohne Pruefung), etc.
    - Separate API-Keys fuer Tests verwenden

MODELLE
-------
  Standard: Gemini 3 Pro (mit Quotas)
  Optional: Claude Sonnet 4.5, OpenAI (konfigurierbar)

  Deep Think: Laengere Reasoning-Ketten fuer komplexe Logik
    Settings > Models > Deep Think toggle

  Thinking Level: low | medium | high
    Steuert Reasoning-Budget

BACH-INTEGRATION
----------------
Aktuelle Integration (Datei-basiert):
  1. GEMINI.md als Metaprompt (wird gelesen!)
  2. system/partners/gemini/ Workspace
  3. Brain-Monitoring (task.md auslesen)

Starter:
  - Interaktiv:  start/start_gemini.bat
  - Script:      python tools/partner_communication/gemini_start.py

Potenzielle Erweiterungen:
  1. BACH als MCP-Server
     - Tasks via MCP lesen/erstellen
     - Memory abfragen
     - Befehle ausfuehren

  2. BACH-Skills als Antigravity-Skills
     - Konvertierung SKILL.md Format
     - Workspace-spezifische Integration

  3. Bidirektionale Task-Sync
     - BACH-Tasks -> Antigravity brain/task.md
     - Antigravity-Ergebnisse -> BACH-Reports

BEKANNTE EINSCHRAENKUNGEN
-------------------------
  - Kein Headless/CLI-only Chat
  - Rate Limits bei kostenloser Nutzung
  - Kein eigener API-Key in GUI (nur CLI)
  - conversations/*.pb nicht lesbar (Protobuf)
  - WSL erfordert spezielle Konfiguration

NUETZLICHE LINKS
----------------
  Download:       https:/antigravity.google/download
  Dokumentation:  https:/antigravity.google/docs
  Skills Doku:    https:/antigravity.google/docs/skills
  Codelabs:       https:/codelabs.developers.google.com/getting-started-google-antigravity

SIEHE AUCH
----------
  wiki/gemini.txt                   Google Gemini KI
  wiki/ollama.txt                   Lokaler LLM-Server
  docs/help/partners.txt                      KI-Partner im BACH-System
  system/partners/gemini/        Gemini Partner-Workspace
