chrome-agent

CLI that gives AI coding agents direct access to Chrome via the DevTools Protocol. Many agents and humans can share one browser, each with isolated event subscr

What is chrome-agent?

CLI that gives AI coding agents direct access to Chrome via the DevTools Protocol. Many agents and humans can share one browser, each with isolated event subscriptions.

Overview of chrome-agent

What it is

chrome-agent is a CLI tool that gives AI coding agents direct access to Chrome browsers via the Chrome DevTools Protocol (CDP). It allows multiple agents and humans to share the same browser simultaneously, each with isolated event subscriptions. The tool sends method names and parameters directly to Chrome and streams back subscribed events without an abstraction layer, meaning any command, event, or domain the installed Chrome supports works immediately.

Key features

  • Direct CDP access with no abstraction layer, providing full protocol capabilities
  • Multiple agents and humans can share one browser with isolated event subscriptions
  • Tracks the running browser version, not its own release, so new protocol features work without updating chrome-agent
  • Two interaction modes: one-shot commands for quick queries and attach mode for persistent event streaming
  • Instance pattern matching with glob support for batch operations
  • Tab completion for zsh that reads live instance names and CDP methods from the running browser

Use cases

  • AI coding agents testing their code by observing and interacting with browsers
  • Debugging automation and inspecting page state
  • Running coordinated test suites with multiple agents against a single browser
  • Human browsing while an agent watches for errors
  • One agent driving browser actions while another observes network traffic

Getting started

bashuv tool install chrome-agentOr add to a project:bashuv add chrome-agentRequires Google Chrome or Chromium installed on the system. Runtime dependencies are websockets, cryptography, and keyring. No Playwright or browser downloads needed.

License and pricing

License: MIT. Pricing: open source (free).

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/captivuschrome-agent.svg)](https://yunodb.com/tools/captivuschrome-agent?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/captivuschrome-agent?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/captivuschrome-agent.svg" alt="Featured on YunoDB" height="20"></a>