connect-chrome

Launches a visible Playwright-controlled Chromium window with the gstack Side Panel extension auto-loaded.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/bobbo01/B2BPlatform --skill connect-chrome-bobbo01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect-chrome
Source: https://github.com/bobbo01/B2BPlatform/tree/main/.agents/skills/gstack-connect-chrome
Command: npx skills add https://github.com/bobbo01/B2BPlatform --skill connect-chrome-bobbo01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Browser automation usually runs headless and invisible, so you cannot see what the AI is actually doing. This Skill connects Claude to a real, visible Chromium window with a Side Panel extension that shows a live activity feed of every command, click, and navigation. ## Core Features & Use Cases - Visible browser control: Launches Playwright's bundled Chromium in headed mode with a golden shimmer indicator, leaving your regular Chrome untouched. - Live activity feed: The auto-loaded gstack extension shows every browse command in a Side Panel as it happens, plus a chat tab where a sidebar agent executes natural-language browser tasks. - Pre-flight recovery: Cleans up stale browse servers and Chromium profile locks before connecting to avoid false "already connected" errors. - Use Case: Run /qa or /design-review and watch every page load, click, and screenshot happen in the visible browser while the Side Panel logs each action. ## Quick Start Ask the assistant to connect Chrome so you can watch it control a real browser window with the Side Panel activity feed.

Frequently Asked Questions about connect-chrome

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude to a real visible Chrome browser?

Run the connect-chrome skill, which builds the gstack browse binary if needed, cleans up stale servers, and runs the connect command. It launches Playwright's bundled Chromium in headed mode with the extension auto-loaded on port 34567.

Does this control my regular Chrome browser?

No. It launches Playwright's bundled Chromium as a separate visible window, so your regular Chrome profile stays untouched. A golden shimmer line at the top of each page identifies the controlled window.

Why does the connection fail with an already connected error?

Stale browse server processes or Chromium profile lock files from a previous crash cause false positives. The skill's pre-flight step kills the old PID from .gstack/browse.json and removes SingletonLock, SingletonSocket, and SingletonCookie files.

What if the gstack extension does not appear in the Side Panel?

Open chrome://extensions and check that gstack browse is listed and enabled. If missing, click Load unpacked and select the extension path printed during setup, then pin it and open the Side Panel, entering port 34567 if the badge stays gray.

What is required to set up the gstack browse tool?

The browse binary must be built once via the skill's setup script, which takes about ten seconds. If bun is not installed, the setup installs it first using the official bun install script.