Antigravity Edge Bridge v2.1 (HTTP Polling)

Secure and reliable bridge connecting Antigravity IDE and Microsoft Edge.
Allows the IDE developer agent to interact directly with your real Edge browser for visual verification, responsive design testing, and automation.

⏱️ Installation Roadmap (Time to Install: ~3 Minutes)

graph TD
    A["1. Load Extension (1 min)"] --> B["2. Run Python Server (30s)"]
    B --> C["3. Run CLI Commands (30s)"]
    C --> D["🚀 Ready to Automate!"]

Step 1: Load the Extension in Edge (1 Minute)

1. Open Microsoft Edge and go to edge://extensions.
2. Turn on the Developer mode toggle (top-right or bottom-left depending on version).
3. Click the Load unpacked (Cargar desempaquetada) button.
4. Select the extension/ folder from this repository.
5. Copy the Extension ID displayed under the extension name (you will need it if you want to install the native host, though the HTTP server runs automatically).

Step 2: Start the Control Server (30 Seconds)

1. Go to the native_host/ folder.
2. Double-click start_bridge_server.bat (or run python native_host/bridge_server.py from your terminal).
3. Keep the terminal window open. The server will run locally on http://localhost:7890.

Step 3: Verify & Use (30 Seconds)

1. Click the Antigravity Edge Bridge icon in your Edge toolbar.
2. The status badge will change to 🟢 ON automatically.
3. Test the connection from your terminal:

   python bridge_cli.py status
   

🤖 Auto-Integration for Antigravity IDE (Zero Config)

This repository includes a pre-configured IDE Skill inside the .agents/skills/edge_bridge/ directory. When you open this project in the Antigravity IDE, the AI coding assistant will automatically discover and load the browser control skills. No manual copy-paste or configuration is needed!

🛠️ CLI Command Reference (bridge_cli.py)

Run commands from the root directory to control your active browser window:

1. Basic Control

• Check Connection Status:

  python bridge_cli.py status
  

• Navigate to URL:

  python bridge_cli.py navigate "https://example.com"
  # Open in a new tab:
  python bridge_cli.py navigate "https://example.com" --new-tab
  

• Take Screenshot:

  python bridge_cli.py screenshot
  # Specify output file:
  python bridge_cli.py screenshot -o custom_name.png
  

2. Device Emulation (Responsive Design)

Simulates screen viewports, pixel density, mobile touch, and User-Agents using the native browser Debugger API:

• Emulate iPhone:

  python bridge_cli.py emulate --device iphone
  

• Emulate Google Pixel:

  python bridge_cli.py emulate --device pixel
  

• Manual Emulation:

  python bridge_cli.py emulate --width 375 --height 812 --scale 3 --mobile
  

• Reset Emulation (Restore Desktop):

  python bridge_cli.py emulate --device reset
  

3. Network Throttling (Connection Simulation)

Simulates slow network environments:

• Simulate Slow 3G:

  python bridge_cli.py network --profile 3g-slow
  

• Simulate Fast 3G:

  python bridge_cli.py network --profile 3g-fast
  

• Simulate 4G:

  python bridge_cli.py network --profile 4g
  

• Go Offline:

  python bridge_cli.py network --profile offline
  

• Restore Normal Network Speed:

  python bridge_cli.py network --profile reset
  

4. DOM Interactions

• Click Element:

  python bridge_cli.py click "#submit-button"
  

• Type Text into Input:

  python bridge_cli.py type "input[name='email']" "test@example.com"
  

• Inspect DOM Node Attributes:

  python bridge_cli.py element ".card-title"
  

🔒 Security and Sandboxing

• Localhost Loopback: All HTTP traffic happens strictly within your machine (127.0.0.1). External networks cannot connect.
• CORS Protection: The Python server checks request origins. Unauthorised web pages trying to call localhost will receive 403 Forbidden errors. Only the local IDE and the official extension are allowed.
• Debugger API Disclosures: Emulation and Throttling commands attach a debugger to the active tab. Edge will display a standard warning banner indicating the browser is being debugged. This warning is safe and can be dismissed.