connect-chrome

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

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/VertaKhan/cs_gstack --skill connect-chrome-vertakhan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: connect-chrome
Source: https://github.com/VertaKhan/cs_gstack/tree/main/.claude/skills/gstack/connect-chrome
Command: npx skills add https://github.com/VertaKhan/cs_gstack --skill connect-chrome-vertakhan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, bun.

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 Chrome window where every click, navigation, and command appears live in a Side Panel activity feed. ## Core Features & Use Cases - Headed Browser Launch: Starts Playwright's bundled Chromium in headed mode with the gstack extension auto-loaded and a golden shimmer line marking the controlled window. - Live Activity Feed: The Side Panel extension shows every browse command (goto, click, fill, snapshot) in real time as Claude executes it. - Sidebar Chat Agent: A child Claude instance in the Side Panel executes natural-language browser tasks like form filling and page reading in an isolated session. - Use Case: Run /qa or /design-review and watch the full test suite execute in the visible browser, seeing every page load, click, and screenshot as it happens. ## Quick Start Ask the AI to connect Chrome and launch a real browser with the side panel so you can watch every action live.

Frequently Asked Questions about connect-chrome

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

FAQPage Schema
How do I watch Claude control a real Chrome browser?▼

Run the connect-chrome skill, which launches Playwright's bundled Chromium in headed mode with the gstack extension loaded. Every command Claude runs appears in the Side Panel activity feed in real time.

Does connect-chrome use my regular Chrome profile?▼

No, it launches Playwright's bundled Chromium as a separate visible window, leaving your regular Chrome untouched. A golden shimmer line at the top of each page marks which window is under control.

Why does the gstack extension not appear in the Side Panel?▼

Check chrome://extensions to confirm gstack browse is listed and enabled, then pin it from the puzzle piece menu. If missing, use Load unpacked with the extension path printed during setup, and enter port 34567 manually if the badge stays gray.

What should I do if the browser says already connected or fails to launch?▼

Run the pre-flight cleanup: kill the stale browse server PID from .gstack/browse.json and delete Chromium SingletonLock, SingletonSocket, and SingletonCookie files in ~/.gstack/chromium-profile, then reconnect.

Can I control the browser with natural language instead of commands?▼

Yes, the Side Panel includes a chat tab where a sidebar agent, a child Claude instance, executes requests like filling forms or describing pages. Each task runs up to 5 minutes in an isolated session.