Tayhlow8/Caixa-D-gua-website-2026 / .agents/skills/gstack
gstack
FlaggedFast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)
scripts/app/gstack-browser
View on GitHub#!/bin/bash
# GStack Browser launcher — starts browse server + headed Chromium with extension
#
# Works in two modes:
# 1. Inside .app bundle: Contents/MacOS/gstack-browser → Resources are at ../Resources/
# 2. Dev mode (run directly): uses global gstack install at ~/.claude/skills/gstack/
#
# Usage:
# open "GStack Browser.app" # .app bundle mode
# scripts/app/gstack-browser # dev mode (uses global gstack install)
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
# Detect mode: .app bundle or dev
if [ -d "$SCRIPT_DIR/../Resources" ]; then
# .app bundle mode — resources are alongside in the bundle
DIR="$(cd "$SCRIPT_DIR/../Resources" && pwd)"
else
# Dev mode — use global gstack install
DIR="$HOME/.claude/skills/gstack"
fi
# Point Playwright at bundled Chromium (only in .app mode)
if [ -d "$DIR/chromium" ]; then
CHROMIUM_APP=$(ls -d "$DIR/chromium/"*.app 2>/dev/null | head -1)
if [ -n "$CHROMIUM_APP" ]; then
export GSTACK_CHROMIUM_PATH="$CHROMIUM_APP/Contents/MacOS/$(ls "$CHROMIUM_APP/Contents/MacOS/" | head -1)"
fi
fi
# Browse server config
export BROWSE_PORT=34567
export BROWSE_HEADED=1
# Extension: bundled first, then global install
if [ -d "$DIR/extension" ]; then
export BROWSE_EXTENSIONS_DIR="$DIR/extension"
fi
# Server script: bundled source first, then global install
if [ -f "$DIR/src/server.ts" ]; then
export BROWSE_SERVER_SCRIPT="$DIR/src/server.ts"
elif [ -f "$HOME/.claude/skills/gstack/browse/src/server.ts" ]; then
export BROWSE_SERVER_SCRIPT="$HOME/.claude/skills/gstack/browse/src/server.ts"
fi
# Browse binary: bundled .app first, then global install
# Note: -x on a directory is true, so check -f (regular file) too
BROWSE_BIN=""
for candidate in "$DIR/browse" "$DIR/browse/dist/browse" "$HOME/.claude/skills/gstack/browse/dist/browse"; do
if [ -f "$candidate" ] && [ -x "$candidate" ]; then
BROWSE_BIN="$candidate"
break
fi
done
if [ -z "$BROWSE_BIN" ]; then
echo "ERROR: browse binary not found. Run 'bun run build' in the gstack repo or reinstall GStack Browser."
exit 1
fi
# Ensure profile directory
mkdir -p ~/.gstack/chromium-profile
# Project binding: use last-used project dir, default to home
PROJECT_DIR=$(cat ~/.gstack/last-project 2>/dev/null || echo "$HOME")
if [ ! -d "$PROJECT_DIR" ]; then
PROJECT_DIR="$HOME"
fi
cd "$PROJECT_DIR"
# Launch browse in connect mode
exec "$BROWSE_BIN" connect "$@"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |