chrome-cdp-skill  by pasky

AI agent access to live Chrome sessions

Created 2 weeks ago

New!

2,767 stars

Top 16.9% on SourcePulse

GitHubView on GitHub
Project Summary

Provides AI agents direct access to live Chrome sessions, enabling interaction with existing tabs, logged-in accounts, and current page states without launching separate browser instances or requiring re-logins. This skill is designed for users who need their AI to leverage their immediate browsing context for tasks requiring authenticated access or interaction with dynamic web content.

How It Works

It connects directly to Chrome's remote debugging WebSocket, bypassing frameworks like Puppeteer. A unique aspect is the creation of a lightweight, persistent background daemon per tab upon first access. This daemon holds the Chrome DevTools Protocol (CDP) session open, ensuring Chrome's "Allow debugging" prompt appears only once per tab and enabling reliable target enumeration even with over 100 tabs open, a common failure point for other tools. Daemons automatically exit after 20 minutes of inactivity.

Quick Start & Requirements

  • Primary install / run command: pi install git:github.com/pasky/chrome-cdp-skill@v1.0.1 or copy the skills/chrome-cdp/ directory.
  • Non-default prerequisites: Node.js 22+.
  • Setup: Enable remote debugging in Chrome via chrome://inspect/#remote-debugging.
  • Links: chrome://inspect/#remote-debugging for setup.

Highlighted Details

  • Direct connection to live Chrome sessions, leveraging existing tabs and logged-in states.
  • Persistent daemon per tab architecture for stable, single-prompt interaction.
  • Proven reliability with 100+ open tabs, outperforming tools prone to timeouts.
  • Comprehensive command set for interaction, inspection, and evaluation within the browser context.

Maintenance & Community

No specific information on contributors, sponsorships, or community channels was found in the provided README.

Licensing & Compatibility

The license type and compatibility notes for commercial use or closed-source linking are not specified in the provided README.

Limitations & Caveats

The primary caveat is that background daemons automatically exit after 20 minutes of inactivity, requiring re-establishment for long-running tasks.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
27
Issues (30d)
9
Star History
2,795 stars in the last 20 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Magnus Müller Magnus Müller(Cofounder of Browser Use), and
4 more.

web-ui by browser-use

0.2%
16k
Web UI for AI browser agent
Created 1 year ago
Updated 7 months ago
Feedback? Help us improve.