gstack

Operate a persistent headless Chromium daemon for automated QA and visual verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, puppeteer-core, and includes scripts (resource) components.

What problem does it solve?

Provides a fast, persistent headless Chromium interface so agents and developers can perform reliable end-to-end QA, dogfooding, and visual verification without manual browser sessions or repeated logins. It reduces brittle selector work by exposing accessibility-based @ref locators, annotated screenshots, diffs, and replayable browser state for reproducible bug reports.

Core Features & Use Cases

  • Persistent headless Chromium daemon with sub-second subsequent command latency for interactive QA sessions and scripted verification.
  • Ref-based element selection (ARIA @e refs and cursor-interactive @c refs) so agents click/fill without brittle CSS selectors.
  • Annotated snapshots, visual diffing, responsive screenshots, element crops, and screenshot evidence suitable for PR bodies and bug reports.
  • Cookie import from real browsers, headed-mode handoff, and secure localhost bearer-token auth for testing authenticated flows.
  • Use cases: automated staging checks before deploy, guided QA runs that generate screenshots + regression tests, and rapid dogfooding of feature flows.

Quick Start

Use the gstack browse skill to open a URL, capture an interactive snapshot, and save an annotated screenshot for bug evidence.

Frequently Asked Questions about gstack

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

FAQPage Schema
How do I automate QA testing without brittle CSS selectors?

Automated QA testing can avoid brittle CSS selectors by using accessibility-based @ref locators. This approach leverages ARIA references for element selection, allowing agents to interact with pages reliably without hardcoding selectors that break on layout changes.

What is the best way to capture annotated screenshots for bug reports?

The best way to capture annotated screenshots for bug reports is using a headless browser that supports visual diffing and responsive screenshots. It generates element crops and annotated snapshots suitable for PR bodies, providing replayable browser state for reproducible issues.

Does Playwright support importing real-browser cookies for authenticated testing?

Yes, Playwright supports importing real-browser cookies for authenticated testing. A persistent headless Chromium interface can import cookies from real browsers, enabling automated QA and multi-step verification across authenticated staging and production flows.

How do I run fast end-to-end QA checks with sub-second latency?

Fast end-to-end QA checks with sub-second latency are possible using a persistent headless Chromium daemon. After warmup, subsequent command latency drops below one second, enabling interactive QA sessions and scripted multi-step verification across staging and production pages.

Can I use a headless browser for visual regression testing and diffing?

Yes, you can use a headless browser for visual regression testing and diffing. It captures annotated snapshots and compares them visually, generating diffs and screenshot evidence suitable for PR bodies and rapid dogfooding of feature flows.

How do I verify authenticated site flows without repeated manual logins?

You can verify authenticated site flows without repeated manual logins by using a persistent headless Chromium interface with cookie import. It maintains session persistence across commands and supports headed-mode handoff for testing secure authenticated flows.