# gstack

> gstack is Garry's Stack: AI coding skills + a fast headless browser binary + a design CLI. This file indexes every capability so agents can discover and invoke them without crawling individual SKILL.md files.

Conventions:

- Skills are invoked by name (e.g. `/ship`, `/plan-ceo-review`).

- Browse commands run as `browse <command> [args]` (or `$B` shorthand).

- Design commands run as `design <command> [args]` (or `$D`).

- Project-specific config lives in `CLAUDE.md`. Always read it first.

## Skills

- [/autoplan](autoplan/SKILL.md): Auto-review pipeline — reads the full CEO, design, eng, and DX review skills from disk and runs them sequentially with auto-decisions using 6 decision principles.

- [/benchmark](benchmark/SKILL.md): Web performance regression detection.

- [/benchmark-models](benchmark-models/SKILL.md): Cross-model benchmark for gstack skills.

- [/browse](browse/SKILL.md): Drive a real browser through Aside: open a page, read it, click through a flow, take screenshots, check console errors.

- [/canary](canary/SKILL.md): Post-deploy canary monitoring.

- [/captain](captain/SKILL.md): Run a crew of coding agents from one controller (also /crew): lanes send READY blocks and never merge; the controller merges through trains, keeps the digest, relays approvals, fixes flakes daily.

- [/careful](careful/SKILL.md): Safety guardrails for destructive commands.

- [/codex](codex/SKILL.md): OpenAI Codex CLI wrapper — three modes.

- [/context-restore](context-restore/SKILL.md): Restore working context saved earlier by /context-save.

- [/context-save](context-save/SKILL.md): Save working context.

- [/cso](cso/SKILL.md): Security audit: supported static findings; qualified profiles add reproduction and repair candidates.

- [/design-consultation](design-consultation/SKILL.md): Design consultation: understands your product, researches the landscape, proposes a complete design system (aesthetic, typography, color, layout, spacing, motion), and generates font+color preview pages.

- [/design-html](design-html/SKILL.md): Design finalization: generates production-quality Pretext-native HTML/CSS.

- [/design-motion](design-motion/SKILL.md): Design motion: animate an approved design into a seamless MP4 and GIF loop.

- [/design-review](design-review/SKILL.md): Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them.

- [/design-shotgun](design-shotgun/SKILL.md): Design shotgun: generate multiple AI design variants, open a comparison board, collect structured feedback, and iterate.

- [/deslop-shared-libs](deslop-shared-libs/SKILL.md): Find worthwhile shared-code extractions in recent work.

- [/devex-review](devex-review/SKILL.md): Live developer experience audit.

- [/diagram](diagram/SKILL.md): Turn an English description (or mermaid source) into a diagram triplet: the source, an editable .excalidraw file you can open on excalidraw.com, and rendered SVG + PNG.

- [/document-generate](document-generate/SKILL.md): Generate missing documentation from scratch for a feature, module, or entire project.

- [/document-release](document-release/SKILL.md): Release documentation audit.

- [/eval-plan](eval-plan/SKILL.md): Preregister a paid eval (bars, arms, decoys, stop rules), dry-run it at zero cost, then run a three-item priced pilot whose spend table gates approval.

- [/freeze](freeze/SKILL.md): Restrict file edits to a specific directory for the session.

- [/gstack](SKILL.md): Router for the gstack skill suite.

- [/gstack-upgrade](gstack-upgrade/SKILL.md): Upgrade gstack to the latest version.

- [/guard](guard/SKILL.md): Full safety mode: destructive command warnings + directory-scoped edits.

- [/health](health/SKILL.md): Code quality dashboard.

- [/investigate](investigate/SKILL.md): Systematic debugging with root cause investigation.

- [/ios-clean](ios-clean/SKILL.md): Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app.

- [/ios-design-review](ios-design-review/SKILL.md): Visual design audit for iOS apps on real hardware.

- [/ios-fix](ios-fix/SKILL.md): Autonomous iOS bug fixer.

- [/ios-qa](ios-qa/SKILL.md): Live-device iOS QA for SwiftUI apps.

- [/ios-sync](ios-sync/SKILL.md): Regenerate the iOS debug bridge against the latest upstream gstack templates.

- [/land-and-deploy](land-and-deploy/SKILL.md): Land and deploy workflow.

- [/landing-report](landing-report/SKILL.md): Read-only queue dashboard for workspace-aware ship.

- [/learn](learn/SKILL.md): Manage project learnings.

- [/make-pdf](make-pdf/SKILL.md): Turn any markdown file into a publication-quality PDF.

- [/modernize](modernize/SKILL.md): Bring an aging pull request onto its current base and decide whether it should still exist: MODERNIZE, REWORK or CLOSE, with range-diff proof before any push.

- [/office-hours](office-hours/SKILL.md): YC Office Hours — two modes.

- [/open-gstack-browser](open-gstack-browser/SKILL.md): Launch GStack Browser — AI-controlled Chromium with the sidebar extension baked in.

- [/pair-agent](pair-agent/SKILL.md): Pair a remote AI agent with your browser.

- [/plan-ceo-review](plan-ceo-review/SKILL.md): CEO/founder-mode plan review.

- [/plan-design-review](plan-design-review/SKILL.md): Designer's eye plan review — interactive, like CEO and Eng review.

- [/plan-devex-review](plan-devex-review/SKILL.md): Interactive developer experience plan review.

- [/plan-eng-review](plan-eng-review/SKILL.md): Eng manager-mode plan review.

- [/plan-tune](plan-tune/SKILL.md): Self-tuning question sensitivity + developer psychographic for gstack (v1: observational).

- [/qa](qa/SKILL.md): Fix browser/API/CLI/job/worker/webhook bugs.

- [/qa-only](qa-only/SKILL.md): Report browser/API/CLI/job/worker/webhook bugs.

- [/retro](retro/SKILL.md): Weekly engineering retrospective.

- [/review](review/SKILL.md): Pre-landing PR review.

- [/scrape](scrape/SKILL.md): Pull data from a web page through the Aside browser — your real, already signed-in sessions.

- [/setup-browser-cookies](setup-browser-cookies/SKILL.md): Import cookies from your real Chromium browser into the headless browse session.

- [/setup-deploy](setup-deploy/SKILL.md): Configure deployment settings for /land-and-deploy.

- [/setup-gbrain](setup-gbrain/SKILL.md): Set up gbrain for this coding agent: install the CLI, initialize a local PGLite or Supabase brain, register MCP, capture per-remote trust policy.

- [/ship](ship/SKILL.md): Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION, update CHANGELOG, commit, push, create PR.

- [/skillify](skillify/SKILL.md): Codify the most recent successful /scrape flow into a permanent browser-skill on disk.

- [/spec](spec/SKILL.md): Turn vague intent into a precise, executable spec in five phases.

- [/sync-gbrain](sync-gbrain/SKILL.md): Keep gbrain current with this repo's code and refresh agent search guidance in CLAUDE.md.

- [/test-audit](test-audit/SKILL.md): Find low-value or duplicate tests and the test-only code they keep alive.

- [/ubicloud](ubicloud/SKILL.md): Run a heavy suite, build or eval on an ephemeral 16-vCPU Ubicloud VM: TTL-named VMs, a reaper, quota preflight and a hang watchdog.

- [/unfreeze](unfreeze/SKILL.md): Clear the freeze boundary set by /freeze, allowing edits to all directories again.

- [/write-skill](write-skill/SKILL.md): Write a new agent skill or improve one without bloat: the edit ladder, levels, drift and size checks, full diets.

## Browse Commands

Run with `browse <command> [args]`. Full reference: `browse/SKILL.md`.

### Extraction

- `archive [path]`: Save complete page as MHTML via CDP.

- `download <url|@ref> [path] [--base64] [--navigate]`: Download URL or media element to disk using browser cookies.

- `scrape <images|videos|media> [--selector sel] [--dir path] [--limit N]`: Bulk download all media from page to --dir (default: <temp>/browse-scrape-<timestamp>).

### Inspection

- `attrs <sel|@ref>`: Element attributes as JSON

- `cdp <Domain.method> [json-params]`: Raw Chrome DevTools Protocol method dispatch.

- `console [--clear|--errors]`: Console messages (--errors filters to error/warning)

- `cookies`: All cookies as JSON

- `css <sel> <prop>`: Computed CSS value

- `dialog [--clear]`: Captured alert/confirm/prompt messages as text/JSON events.

- `eval <file> [--out <file>] [--raw]`: Run JavaScript from a file in the page context and return result as string.

- `inspect [selector] [--all] [--history]`: Deep CSS inspection via CDP.

- `is <prop> <sel|@ref>`: State check on element.

- `js <expr> [--out <file>] [--raw]`: Run inline JavaScript expression in the page context and return result as string.

- `network [--clear]`: Captured network requests as lines with method, status, resource type, and URL.

- `perf`: Page load timings as JSON-ish milliseconds for navigation/load phases

- `storage | storage set <key> <value>`: Read both localStorage and sessionStorage as JSON.

- `ux-audit`: Extract page structure for UX behavioral analysis — site ID, nav, headings, text blocks, interactive elements.

### Interaction

- `cleanup [--ads] [--cookies] [--sticky] [--social] [--overlays] [--clutter] [--all]`: Remove page clutter by hiding matched elements.

- `click <sel>`: Click element

- `cookie <name>=<value>`: Set cookie on current page domain

- `cookie-import <json>`: Import cookies from JSON file

- `cookie-import-browser [browser] [--domain d] [--profile p] [--all] [--clear-storage] [--verify-auth]`: Copy cookies from chrome, chromium, brave, edge, Windows-only opera, opera-gx, or macOS-only comet or arc.

- `dialog-accept [text]`: Auto-accept next alert/confirm/prompt.

- `dialog-dismiss`: Auto-dismiss next dialog

- `fill <sel> <val>`: Fill input

- `header <name>:<value>`: Set custom request header (colon-separated, sensitive values auto-redacted)

- `hover <sel>`: Hover element

- `press <key>`: Press a Playwright keyboard key against the focused element.

- `scroll [sel|@ref]`: With a selector, smooth-scrolls the element into view.

- `select <sel> <val>`: Select dropdown option by value, label, or visible text

- `style <sel> <prop> <value> | style --undo [N]`: Modify CSS property on element (with undo support)

- `type [--selector <sel>] [--] <text>`: Send keystrokes to the focused element, or to <sel> with --selector (focuses it first).

- `upload <sel> <file> [file2...]`: Upload file(s)

- `useragent <string>`: Set user agent

- `viewport [<WxH>|auto] [--scale <n>]`: Set viewport size and optional deviceScaleFactor (1-3, for retina screenshots).

- `wait <sel|--networkidle|--load>`: Wait for element, network idle, or page load (timeout: 15s)

### Meta

- `chain (JSON via stdin)`: Run a sequence of commands from JSON on stdin.

- `domain-skill save|list|show|edit|promote-to-global|rollback|rm <host?>`: Per-site notes the agent writes for itself.

- `frame <sel|@ref|--name n|--url pattern|main>`: Switch command context to an iframe, or `main` to return to the top page.

- `inbox [--clear]`: List sidebar inbox messages from the visible browser extension as JSON/text; --clear removes them after reading.

- `skill list|show|run|test|rm <name?> [--arg k=v]... [--timeout=Ns]`: Run a browser-skill: deterministic Playwright script that drives the daemon over loopback HTTP.

- `watch [stop]`: Start passive observation mode: records periodic snapshots while the user browses and blocks mutation commands.

### Navigation

- `back`: History back

- `forward`: History forward

- `goto <url>`: Navigate to URL (http://, https://, or file:// scoped to cwd/TEMP_DIR)

- `load-html <file> [--wait-until load|domcontentloaded|networkidle] [--tab-id <N>] | load-html --from-file <payload.json> [--tab-id <N>]`: Load HTML via setContent.

- `reload`: Reload page

- `url`: Print current URL

### Reading

- `accessibility`: Full ARIA tree

- `data [--jsonld|--og|--meta|--twitter]`: Structured data: JSON-LD, Open Graph, Twitter Cards, meta tags

- `forms`: Form fields as JSON

- `html [selector]`: innerHTML of selector (throws if not found), or full page HTML if no selector given

- `links`: All links as "text → href"

- `media [--images|--videos|--audio] [selector]`: All media elements (images, videos, audio) with URLs, dimensions, types

- `text [selector|@ref]`: Cleaned visible page text, or cleaned text for a CSS selector/@ref when one is provided

### Server

- `connect [--supervise]`: Launch headed Chromium with Chrome extension; --supervise keeps the CLI attached and respawns a crashed server

- `disconnect`: Disconnect headed browser, return to headless mode

- `focus [@ref]`: Bring headed browser window to foreground (macOS)

- `handoff [message]`: Open visible Chrome at current page for user takeover

- `memory [--json]`: Snapshot Bun heap + per-tab JS heap + Chromium process tree + bounded buffer sizes.

- `restart`: Restart server

- `resume`: Re-snapshot after user takeover, return control to AI

- `state save|load <name>`: Save/load browser state (cookies + URLs)

- `status`: Health check

- `stop`: Shutdown server

### Snapshot

- `snapshot [flags]`: Accessibility tree with @e refs for element selection.

### Tabs

- `closetab [id]`: Close tab

- `newtab [url] [--json]`: Open new tab.

- `tab <id>`: Switch to tab

- `tab-each <command> [args...]`: Run a command on every open tab.

- `tabs`: List open tabs

### Visual

- `diff <url1> <url2>`: Text diff between pages

- `pdf [path] [--format letter|a4|legal] [--width <dim> --height <dim>] [--margins <dim>] [--margin-top <dim> --margin-right <dim> --margin-bottom <dim> --margin-left <dim>] [--header-template <html>] [--footer-template <html>] [--page-numbers] [--tagged] [--outline] [--print-background] [--prefer-css-page-size] [--toc] [--tab-id <N>] | pdf --from-file <payload.json> [--tab-id <N>]`: Save the current page as PDF.

- `prettyscreenshot [--scroll-to sel|text] [--cleanup] [--hide sel...] [--width px] [path]`: Clean screenshot with optional cleanup, scroll positioning, and element hiding

- `responsive [prefix]`: Screenshots at mobile (375x812), tablet (768x1024), desktop (1280x720).

- `screenshot [--selector <css>] [--viewport] [--clip x,y,w,h] [--base64] [selector|@ref] [path]`: Save screenshot.

## More

- Repository: https://github.com/garrytan/gstack

- Top-level guide: `SKILL.md`

- Project ethos: `ETHOS.md`

- This file is auto-generated by `bun run gen:skill-docs`.