gstack

Automates browser-based QA with persistent headless Chromium sessions and evidence outputs.

8|2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/MFS-code/gstack --skill gstack-mfs-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack
Source: https://github.com/MFS-code/gstack/tree/main
Command: npx skills add https://github.com/MFS-code/gstack --skill gstack-mfs-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

gstack solves the problem of slow, fragile QA and site dogfooding by giving agents a persistent headless Chromium browser to navigate, interact, verify UI state, and capture evidence like diffs and screenshots.

Core Features & Use Cases

  • Persistent headless browser: keeps cookies, tabs, and session state across commands so login and multi-step flows don’t restart every time.
  • Evidence-first testing: supports snapshot diffs, annotated screenshots, console/network/dialog inspection, and responsive layout checks.
  • Reliable element interaction: uses ref-based selectors from accessibility snapshots (and cursor-interactive refs when needed) to avoid brittle CSS guessing.

Quick Start

Use the gstack skill to QA a page by running your test flow on a real URL and capturing screenshots and snapshot diffs as evidence.

Frequently Asked Questions about gstack

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

FAQPage Schema
How do I automate UI verification to capture screenshot evidence for bug reports?

Automated UI verification captures screenshot evidence by navigating pages in a headless browser, interacting with elements, and saving annotated screenshots and snapshot diffs. This validates user flows and deployments while providing persistent session state for reliable testing.

How does a persistent headless browser maintain session state for multi-step QA testing?

A persistent headless browser maintains session state by keeping cookies, tabs, and session data active across sequential commands. This enables continuous multi-step QA testing flows without restarting login sessions or losing context between automated interactions.

How do I test responsive layouts across different viewports in a headless browser?

Testing responsive layouts across viewports involves running automated browser workflows that resize the headless browser window and capture visual evidence. This process validates UI rendering and behavior across multiple screen dimensions using snapshot diffs and annotated screenshots.

Why does snapshot diffing use accessibility refs instead of CSS selectors for element targeting?

Snapshot diffing uses ref-based selectors from accessibility snapshots to avoid brittle CSS guessing during element interaction. This method provides reliable element targeting by referencing structural page data rather than relying on volatile styling selectors that break during UI changes.

Can I inspect console logs and network requests during automated browser workflows?

You can inspect console logs and network requests during automated browser workflows to verify application behavior and capture bug evidence. This inspection runs alongside navigation and element interaction within the persistent headless browser session.

What is the best way to validate production deployments without manual site dogfooding?

Validating production deployments without manual site dogfooding is best achieved through automated headless browser workflows. These workflows navigate real URLs, interact with page elements, and generate unified diffs and annotated screenshots as persistent evidence of production behavior.