obra/superpowers-chrome

Claude Code plugin for direct Chrome browser control via DevTools Protocol - zero dependencies

What it solves

Superpowers Chrome provides a way for AI agents (specifically Claude Code and other MCP clients) to directly control a web browser. It eliminates the need for complex setup by providing a zero-dependency bridge to the Chrome DevTools Protocol (CDP), allowing agents to navigate pages, interact with elements, and extract data without needing a heavy automation framework.

How it works

The project operates in two primary modes:

  1. Skill Mode: A CLI tool designed for Claude Code agents to use as a browsing skill.
  2. MCP Mode: An ultra-lightweight Model Context Protocol (MCP) server that provides a use_browser tool to any compatible MCP client.

It uses a dynamically allocated port system to avoid conflicts and supports multiple browser profiles in parallel. To prevent sensitive data leaks, it includes a robust "credential-shaped content" detection system that redacts secrets (like API tokens and passwords) from HTML, Markdown, and screenshots before they are written to disk or returned to the agent.

Who it’s for

  • AI Agent Developers: Those building agents that need to perform web-based tasks, research, or automation.
  • Claude Code Users: Users wanting to extend Claude's capabilities with direct browser access.
  • MCP Client Users: Anyone using an MCP-compatible interface to give their LLM browser control.

Highlights

  • Zero Dependencies: Built using built-in WebSockets, requiring no npm install for the CLI tool.
  • Advanced Dialog Handling: Surfaces JavaScript alerts, confirms, and permission prompts as synthetic responses, allowing agents to interact with them using a specific selector grammar (e.g., dialog::accept).
  • Automatic Page Captures: Automatically generates HTML, Markdown, screenshots, and DOM summaries after DOM-changing actions.
  • Privacy Guardrails: Comprehensive redaction of credential-shaped content and a data-sen-secret marker system to protect sensitive information.
  • Cross-Platform: Works across macOS, Linux, and Windows with platform-agnostic launch commands.

Related

  • Project
  • Project
  • Project
  • Project
  • Project