connect-chrome

Launch and control a visible Chrome browser with the gstack extension loaded.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/GenEducation/GenedUIProject --skill connect-chrome-geneducation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: connect-chrome
Source: https://github.com/GenEducation/GenedUIProject/tree/main/.gemini/skills/connect-chrome
Command: npx skills add https://github.com/GenEducation/GenedUIProject --skill connect-chrome-geneducation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of setting up a real browser session when you need to watch actions happen live, inspect pages visually, or control Chrome in a way that feels immediate and trustworthy.

Core Features & Use Cases

  • Visible browser control: Opens a headed Chromium window so every click, navigation, and page state change is easy to observe.
  • Extension-assisted workflows: Auto-loads the Side Panel extension so browser actions can be monitored and coordinated in real time.
  • Session verification and recovery: Checks browser mode, port, and extension path, and includes cleanup steps for stale locks and crashed sessions.
  • Use case: Use it when you need to connect to Chrome for debugging, QA, live demos, or any task where seeing the browser state matters more than running headless.

Quick Start

Ask the skill to connect Chrome so it launches a visible browser window with the Side Panel extension loaded and ready to use.

Frequently Asked Questions about connect-chrome

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

FAQPage Schema
How do I launch a headed Chrome browser for live QA and debugging?

To launch a headed Chrome browser for live QA, the session opens a visible Chromium window with a fixed control port and auto-loads the Side Panel extension for real-time observation of clicks and page state changes.

Can I use this to monitor browser automation in real time?

Yes, you can monitor browser automation in real time because the environment runs a visible, headed Chromium session, allowing you to visually inspect page navigation and extension-assisted workflows as they execute.

Does this setup support running Playwright tests in a visible browser?

This setup supports running Playwright tasks in a visible browser by providing a headed Chromium session with persistent browser state and a fixed control port, ensuring actions are easy to observe rather than running headless.

How do I fix a stale Chrome session or crashed browser lock?

To fix a stale Chrome session or crashed browser lock, the connection process includes explicit verification of the browser mode and port, alongside automated cleanup steps to clear stale locks and recover crashed sessions.

When should I avoid using a headed browser session?

You should avoid using a headed browser session when running fully automated background pipelines where visual observation is unnecessary, as this environment specifically targets live demos, manual inspection, and debugging tasks.

Do I need a specific extension to control Chrome with this setup?

Yes, the setup requires the gstack Side Panel extension, which is automatically loaded into the persistent browser state to coordinate and monitor browser actions in real time.