Skip to main content
Glama

Universal AI Browser Control πŸŒπŸ€–

Open-Source Autonomous AI Browser Extension + Universal MCP Server & CLI Hub

License: MIT GitHub Repository Vercel Deployment Manifest V3 Model Context Protocol Design System Author

Live Production Web Portal & Cloud Relay:
πŸ‘‰ https://universal-browser-control.vercel.app

Public GitHub Repository:
πŸ‘‰ https://github.com/abdulaaly/universal-browser-control

Download Packaged Chrome Extension (.zip):
πŸ‘‰ extension-v1.0.0-chrome.zip

Universal AI Browser Control is a 100% open-source, vendor-agnostic browser automation system engineered to surpass closed proprietary extensions (such as the ChatGPT Chrome Extension hehggadaopoacecdllhhajmbjkdcmajg).

It provides an open bridge allowing ANY AI clientβ€”including Google Gemini, Anthropic Claude (Web, Desktop, iOS, Android), Perplexity, Cursor, and the Antigravity CLIβ€”to safely control the user's live, authenticated desktop browser session without hijacking active tabs or exposing credentials.


🎨 Tier-1 "Obsidian Command" Design System

The UI was crafted from the ground up utilizing the official Obsidian Command design specification (synthesizing Linear, Raycast, and Cursor design tokens):

  • Obsidian Monolithic Palette: Pure dark canvas (#08090b), surface ladder (#0e1015 β†’ #14171f β†’ #191d27), and hairline borders (1px solid #232834).

  • Tactile Micro-Actions: 2x2 grid in both the popup and sidepanel for instant DOM indexing, viewport capture, Markdown extraction, and agent cursor positioning.

  • Dedicated Popup Hub (popup.html): Compact 360x520px extension popup featuring active tab domain, live CDP status badge, segmented transport switch (Local WS / Public Tunnel), and 1-click PAT token rotation.

  • 5-Tab Multi-Modal Sidepanel (sidepanel.html):

    1. Agent Stream: Natural-language prompt box with ⌘⏎ keycap, live timeline action feed, and emergency Interrupt Run (Esc) button.

    2. DOM Inspector: Searchable element index table with selector tags and numeric markers [1]..[n].

    3. DOM Actions: Zero-friction action playground to dispatch clicks, synthesized typing, and background navigations.

    4. Security HITL: Human-In-The-Loop safety guardrails, sensitive domain interceptor, and whitelisted domains.

    5. Protocol Logs: Real-time CDP and MCP JSON-RPC protocol trace stream.


Related MCP server: Tato Runtime

🌟 Key Superpowers & Capabilities

  • πŸ”“ 100% Vendor Agnostic: Works identically with Gemini, Claude, Perplexity, Cursor, Antigravity, or custom autonomous agents via standard Model Context Protocol (MCP).

  • πŸ›‘οΈ Zero Tab Hijacking & Background Leases: Operates smoothly in background tabs using Chrome DevTools Protocol (chrome.debugger) and tab leases without stealing focus while you work.

  • πŸ‘οΈ Token-Optimized DOM Indexer: Converts web pages into compact, numbered interactive element markers ([1], [2], [3]) and human-readable Markdown summaries.

  • πŸ–±οΈ Natural Visual Agent Cursor: Injects a physics-based Bezier cursor trail and click ripple animation inside an isolated Shadow DOM container (closed mode) so you see exactly what the AI is doing in real-time.

  • 🚨 Human-in-the-Loop (HITL) Guardrails: High-risk actions (file downloads, browser history access, form submissions on unknown domains) pause for interactive approval cards ([Allow Once], [Trust Domain], [Deny]).

  • πŸ›‘ Pre-configured Sensitive Domain Blocklist: Automatic denial on banking portals, password managers, and critical identity providers (chase.com, paypal.com, 1password.com, bitwarden.com, etc.).

  • πŸ“‘ Dual Transport Modes:

    • Local stdio Transport: Zero-latency IPC for local coding assistants (Antigravity, Cursor, Terminal).

    • Remote SSE / Streamable HTTP & WSS Cloud Relay: Enables remote mobile and web clients (Claude on iPhone, Gemini Web in the cloud) to command your desktop browser across networks with Firebase Auth & 2FA.


πŸ—οΈ Monorepo Architecture

universal-browser-control/
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ extension/         # Chrome/Edge/Brave Extension (React + Vite + Tailwind + MV3)
β”‚   β”œβ”€β”€ mcp-server/        # Universal MCP Server (@modelcontextprotocol/sdk, stdio & SSE)
β”‚   β”œβ”€β”€ cli/               # CLI-Anything zero-config hub (npx universal-browser)
β”‚   └── firebase-backend/  # Firebase Auth, 2FA, Scoped PATs & WSS Cloud Relay
β”œβ”€β”€ reference-extension/   # Deconstructed ChatGPT Chrome Extension (hehggadaopoacecdllhhajmbjkdcmajg)
β”œβ”€β”€ api/                   # Production Vercel Serverless MCP SSE & Relay Gateway
β”œβ”€β”€ public/                # Live Production Web Companion Hub
β”œβ”€β”€ ARCHITECTURE.md        # Comprehensive technical deconstruction & architectural specification
β”œβ”€β”€ DESIGN.md              # Tier-1 Obsidian Command Design System Specification
β”œβ”€β”€ SETUP.md               # Step-by-step connection guide for Gemini, Claude, Perplexity, Cursor
β”œβ”€β”€ firebase.json          # Production Firebase configuration
β”œβ”€β”€ firestore.rules        # Strict user-isolation security rules
└── LICENSE                # MIT License

πŸš€ Quickstart Guide

Prerequisites

  • Node.js >= 18.0.0

  • Google Chrome, Microsoft Edge, or Brave Browser

1. Build the Monorepo

# Clone the repository
git clone https://github.com/abdulaaly/universal-browser-control.git
cd universal-browser-control

# Install all workspace dependencies
npm install

# Build all packages
npm run build

2. Load the Chrome Extension

  1. Open Google Chrome and navigate to chrome://extensions.

  2. Enable Developer mode in the top-right corner.

  3. Click Load unpacked and select the directory: universal-browser-control/packages/extension/dist (or universal-browser-control/chrome-extension)

  4. Pin the Universal AI Browser Control icon in your Chrome toolbar.

  5. Click the extension icon to view the compact Popup Hub or open the Side Panel to inspect live telemetry.

3. Start the Local MCP Bridge

# Start local stdio MCP server for Antigravity or local agents
npx universal-browser start

# Or start in SSE streaming mode for remote web/mobile AI clients:
npx universal-browser start --sse --port 3000

πŸ€– AI Client Connection Configurations

1. Anthropic Claude (Web & iOS / Android Mobile)

Add the MCP configuration to your Claude Desktop config (claude_desktop_config.json) or mobile connection:

{
  "mcpServers": {
    "universal-browser": {
      "url": "https://universal-browser-control.vercel.app/api/mcp/sse",
      "headers": {
        "Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"
      }
    }
  }
}

2. Google Gemini (Web, API & CLI)

Add the MCP server configuration into your Gemini runtime:

{
  "mcpServers": {
    "universal-browser": {
      "url": "https://universal-browser-control.vercel.app/api/mcp/sse",
      "headers": {
        "Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"
      }
    }
  }
}

3. Cursor IDE

In Cursor Settings β†’ Features β†’ MCP, add a new SSE Server:

  • Name: universal-browser

  • Type: sse

  • URL: https://universal-browser-control.vercel.app/api/mcp/sse

  • Headers: {"Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"}

4. Perplexity AI

Under Perplexity Developer Settings / MCP Connections:

{
  "mcpServer": {
    "name": "universal-browser",
    "transport": "sse",
    "endpoint": "https://universal-browser-control.vercel.app/api/mcp/sse",
    "bearerToken": "ub_pat_live_89f0a8c2b7d41e9e03"
  }
}

5. Antigravity & Local CLI

Zero-config instant bridge via terminal:

npx @universal-browser/cli connect --url https://universal-browser-control.vercel.app/api/mcp/sse

πŸ“Š Comparison: Vendor-Locked Extension vs. Universal AI Browser Control

Feature

Original ChatGPT Extension (hehggadaop...)

Universal AI Browser Control

Supported Models

ChatGPT Web Only

Gemini, Claude (Web/Mobile), Perplexity, Cursor, Antigravity CLI

Remote / Mobile Control

❌ No

βœ… Full SSE & Encrypted Cloud Relay

Dual Transport (stdio + SSE)

❌ Stdio/Local Only

βœ… Both Local stdio and Remote SSE

Background Tab Isolation

Partial

βœ… Full CDP Background Leases

Visual Agent Cursor

Basic

βœ… Physics-Based Bezier Curve & Click Ripple

Security Guardrails

Basic Confirmation

βœ… 3-Tier HITL ([Allow Once], [Domain], [Deny]) + 2FA

Sensitive Domain Blocking

Limited

βœ… Hard-Coded Bank/Vault Blocklist

Design System

Generic UI

βœ… Tier-1 Obsidian Command (Linear/Raycast/Cursor)

Source Code & License

Proprietary & Minified

βœ… 100% Open-Source (MIT)


πŸ›‘οΈ Security & Privacy Architecture

  1. Local-First Execution: By default, all CDP commands execute locally on your machine.

  2. Explicit User Leases: The extension only connects to tabs when an automation action is triggered.

  3. No Credential Harvesting: The extension never inspects password input values or transmits cookies.

  4. Instant Emergency Kill-Switch: Users can hit Esc or click Interrupt Run at any microsecond to revoke automation leases immediately.


πŸ“„ License & Attribution

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP-speaking AI agents to operate a desktop and browser through structured UI inspection, mouse/keyboard gestures, tab-scoped browsing, and approved local screen recording with editing.
      3
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables any MCP-capable AI agent to operate the user's own everyday Chrome browser with all existing login sessions intact, offering 22 tools for reading page/network data, filling forms, clicking, batch multi-step actions, and handing CAPTCHAs or confirmations back to the human β€” without API keys, debug ports, or launch flags.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents and MCP clients to safely control the user's real Chrome browser, using shared tabs with per-site approvals, credential-field protection, a kill switch, and an activity log.
      11 npm
      Apache 2.0