What problem does it solve?
Many browser-driven QA and dogfooding workflows are slow, flaky, and lose session state because each tool launches a fresh browser. gstack provides a persistent headless Chromium daemon with ref-based element selection so agents and CLI workflows run sub-second commands, preserve cookies/tabs, and produce reliable evidence (annotated screenshots, diffs, logs) for testing and verification.
Core Features & Use Cases
- Persistent daemon: long-lived Chromium process that avoids repeated cold starts and preserves cookies, tabs, and localStorage across commands.
- Ref-based interaction:
snapshot assigns @e/@c refs to elements so agents can click/fill without brittle CSS selectors.
- Verification tools: snapshot diffs (-D), annotated screenshots (-a -o), responsive screenshots, perf metrics, console/network/dialog buffers, and multi-step
chain execution.
- Auth & handoff: import real browser cookies, headed-mode (
connect) for live handoff, and handoff/resume to let a human solve CAPTCHAs or MFA then continue automated flows.
- Use cases: QA regression testing, deployment verification, form flows with authentication, visual diffs for PRs, and automated multi-step user journeys.
Quick Start
Launch the gstack browse binary and use its $B commands (goto, snapshot, click, screenshot) to open a page, capture interactive refs, and save an annotated screenshot.