gstack

Automate headless Chromium browser testing and QA workflows via a compiled CLI.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/psyche911/AntigravityTest --skill gstack-psyche911
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gstack
Source: https://github.com/psyche911/AntigravityTest/tree/main/.claude/skills/gstack
Command: npx skills add https://github.com/psyche911/AntigravityTest --skill gstack-psyche911

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, diff.

What problem does it solve? AI coding agents cannot see or interact with live web applications, forcing developers to manually click through pages, verify deployments, and test user flows by hand. ## Core Features & Use Cases - Headless Browser Automation: Navigate URLs, click elements, fill forms, upload files, and handle dialogs through a persistent Chromium session with ~100ms per command. - Ref-Based Interaction: Snapshot the accessibility tree to get stable element references (@e1, @e2) instead of guessing CSS selectors, with diff, annotation, and cursor-interactive scanning modes. - QA Evidence Collection: Take annotated screenshots, check console errors, test responsive layouts, and assert element states to document bugs with reproducible evidence. - Use Case: After pushing a branch, instruct the agent to log into staging, walk through the signup flow, screenshot each page, and report console errors — a full QA pass without opening a browser. ## Quick Start Ask the agent to use the gstack browse skill to open your staging URL, fill in the login form, and screenshot the dashboard to verify the deployment.

Frequently Asked Questions about gstack

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

FAQPage Schema
How do I automate browser testing with Claude Code?▼

Install gstack and use the /browse skill, which exposes a compiled CLI for navigating URLs, clicking elements, filling forms, and taking screenshots. The browser persists between commands so cookies and sessions carry over.

How to test authenticated pages in a headless browser?▼

Use the cookie-import-browser command to decrypt and import cookies from installed Chromium browsers like Chrome, Arc, or Brave. An interactive picker UI lets you select which domains to import into the Playwright session.

Does gstack browse work on Linux and macOS?▼

Yes, the compiled binary supports macOS and Linux on x64 and arm64. It requires Bun v1.0+ and Playwright's Chromium, which the setup script installs automatically.

Why use a CLI instead of Playwright MCP for browser automation?▼

MCP tools add roughly 1500-2000 tokens of protocol overhead per call, while the gstack CLI outputs plain text with zero context overhead. Subsequent commands also run in 100-200ms versus 1-5 seconds for MCP connections.

What are the limitations of ref-based element selection?▼

Refs are invalidated on page navigation, so you must run snapshot again after each goto. Elements without ARIA roles may also be missed unless you use the -C flag to scan for cursor-interactive elements.