What problem does it solve?
gstack provides a persistent, fast headless Chromium environment so agents can interact with real web pages for QA, dogfooding, and regression verification without paying browser startup or state-loss costs on every command.
Core Features & Use Cases
- Persistent headless Chromium daemon with Bun-compiled CLI for sub-second follow-up commands.
- Snapshot system that assigns accessibility-based @refs, supports annotated screenshots, unified diffs, and cursor-interactive (@c) refs for hard-to-find click targets.
- Interaction primitives: click, fill, upload, dialog control, network/console capture, iframe support, viewport/responsive testing, and chainable multi-step flows.
- Cookie import from real Chromium profiles, headed-mode with a Chrome side-panel for live observation and a sidebar agent, and state save/load for reproducible sessions.
- Use cases: verify staging vs prod deployments, reproduce and capture bugs with annotated evidence, run end-to-end QA flows, and generate visual diffs for PRs.
Quick Start
Invoke the browse QA flow to test a URL and produce evidence, for example ask: "Run /qa on https://staging.example.com and produce annotated screenshots and a bug report".