$ npx chrome-bridge navigate "https://news.ycombinator.com"
✓ Opened dedicated window [Tab #1341700812] in 14ms

PAGE SNAPSHOT [URL: https://news.ycombinator.com]
--------------------------------------------------------------------------------
@1 [a] "Hacker News" (/news)
@2 [a] "new" (/newest)
@3 [a] "comments" (/newcomments)
@4 [a] "Show HN: Chrome Browser Bridge" (https://github.com/...)
@5 [span] "142 points by rahulbomnalli 2 hours ago"
@6 [input:text] (Search)
--------------------------------------------------------------------------------

$ npx chrome-bridge click @4
✓ Clicked element @4 -> Navigated to repository (8ms)

+---------------------------------------------------------------+
|  🟣 Agent Working: Typing into search and clicking @1...     |
+---------------------------------------------------------------+

+---------------------------------------------------------------+
|     AI Agents (Claude Desktop / Antigravity / Cursor / CLI)   |
+---------------------------------------------------------------+
                               |
                   MCP (stdio) / CLI / REST
                               v
+---------------------------------------------------------------+
|       Local Bridge Server (Node.js on 127.0.0.1:8765)         |
+---------------------------------------------------------------+
                               ^
                  WebSocket (ws://127.0.0.1:8765)
                               v
+---------------------------------------------------------------+
|   Chrome MV3 Extension (Service Worker & Content Engine)      |
+---------------------------------------------------------------+
                               |
                  Chrome DevTools Protocol (CDP)
                               v
+---------------------------------------------------------------+
|     Your Real Google Chrome Browser (All Cookies & Logins)    |
+---------------------------------------------------------------+

git clone https://github.com/rahulbomnalli/chrome-browser-bridge.git
cd chrome-browser-bridge
npm install

./run.sh
# or: npm start

run.bat
# or: npm start

{
  "mcpServers": {
    "chrome-browser-bridge": {
      "command": "node",
      "args": ["<PATH_TO_REPO>/mcp-server.js"]
    }
  }
}

{
  "mcpServers": {
    "chrome-browser-bridge": {
      "command": "node",
      "args": ["<PATH_TO_REPO>/mcp-server.js"]
    }
  }
}

# Check bridge and extension connection status
node cli.js status

# List all open Chrome tabs
node cli.js tabs

# Open a URL in an isolated agent window and get semantic element tree
node cli.js navigate "https://github.com"

# Click an element by compact index, CSS selector, or visible text
node cli.js click @1
node cli.js click "#login-button"
node cli.js click "Sign In"

# Type text into an input field (--enter submits automatically)
node cli.js type @2 "search query" --enter

# Fill an entire form in under 50ms
node cli.js batch-fill '{"Email": "dev@test.com", "Password": "password123"}' "Submit"

# Visual Grounding: Injects [1], [2], [3] tags for Canvas / WebGL / TradingView
node cli.js ground

# Extract distraction-free readability content
node cli.js read

# Execute JavaScript directly in the active tab context
node cli.js eval "window.location.href"

# Take high-resolution screenshot
node cli.js screenshot "output.png"

# Execute a multi-step macro pipeline in 1 single round-trip
node cli.js pipeline '[
  {"action":"type","params":{"target":"#search","text":"ai bridge"}},
  {"action":"press","params":{"key":"Enter"}},
  {"action":"wait","ms":300},
  {"action":"click","params":{"target":"@1"}}
]'

# Run parallel scraping across multiple URLs in < 2 seconds
node cli.js scrape "https://news.ycombinator.com" "https://github.com/trending"