antigravity-plugin-browser-plugin/README.md

Browser Plugin (browser-plugin)

The browser-plugin provides real-time Chrome browser automation, tab inspection, accessibility auditing, DOM interaction, element screenshotting, and CDP trace performance profiling for Antigravity AI agents.

---

Architecture & Integration Options

1. Direct MCP Tool Calling (Fastest)

Invoke browser tools directly from any active turn via call_mcp_tool:

call_mcp_tool(
  ServerName="browser-tools",
  ToolName="chrome_read_page",
  Arguments={"tabId": 863242845}
)

• Use when: You need a quick DOM lookup, single screenshot, or single tab navigation while pair-programming.

2. Skill-Guided Workflows (browser-automation)

Activate the browser-automation skill in your turn for inline workflow guidance and DOM inspection strategies.

• Use when: Performing multi-step browser interactions (form fills, visual regression checks, CDP trace analysis).

3. Subagent Delegation (browser:browser-agent / self)

Delegate long-running or multi-page browser exploration to a dedicated subagent via invoke_subagent:

invoke_subagent(Subagents=[{
  "TypeName": "browser:browser-agent",
  "Role": "Browser Automation Agent",
  "Prompt": "Inspect open tabs, navigate to target page, and report accessibility tree."
}])

• Use when: Offloading heavy background web exploration, batch screenshot capture, or automated E2E testing without cluttering the main conversation window.

---

Plugin Contents

• plugin.json: Plugin manifest metadata.
• .mcp.json: Endpoint definition (http://127.0.0.1:12010/p/browser/mcp).
• agents/browser_agent.py: Agent builder for browser:browser-agent.
• skills/browser-automation/SKILL.md: Skill documentation and decision matrix.