# gstack

Source: https://trendhub.net/skills/garrytan-gstack
Repository: https://github.com/garrytan/gstack
Author: Garry Tan (https://github.com/garrytan)
License: MIT
GitHub stars: 141,868

gstack is Garry Tan's set of slash-command skills that has a coding agent take on specialist roles across a sprint: product questioning, plan reviews, design, code review, real-browser QA, security audit and release. Each skill writes artifacts the next one reads, from design doc to test plan to PR. It suits founders and tech leads who want structured review and release steps around agent-written code.

## What problems it solves

- **The agent builds the wrong thing**: An office-hours session questions your framing, challenges premises and writes a design doc before any code exists.
- **Bugs pass CI but break production**: A pre-landing review reads the full diff, runs specialist and adversarial passes and auto-fixes only the obvious issues.
- **Nobody actually clicks through the app**: The QA skill opens a real browser or probes APIs and CLIs, reproduces each bug, writes a regression test and fixes it.
- **Shipping steps get skipped**: The ship workflow merges the base, runs tests and reviews, bumps the version and changelog, verifies and opens the PR.

## Install

### Claude Code

The README wraps this command in a prompt you paste into Claude Code, which also adds a short gstack section to CLAUDE.md.

```
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
```

### Claude Code (team mode for a shared repo)

Run inside your repo; it commits a bootstrap so teammates get gstack with auto-updates, and needs Node.js for the required hook.

```
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"
```

### Codex, Cursor, OpenCode, Gemini CLI and other agents

Use --host auto for every detected agent or name one host; non-Claude hosts are listed as experimental.

```
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host auto # or: ./setup --host codex
./setup --status # one row per install: host, tier, scope, version, path
```

You need Git and Bun 1.4.2 or later (plus Node.js on Windows); Claude Code gets the fullest support, while Codex, Cursor, Gemini CLI and others install through ./setup --host as experimental targets. On macOS the browser skills prefer the Aside browser with your signed-in sessions and otherwise fall back to a bundled Chromium that setup builds.

## Skills

Skill names are shown as /name. Depending on the agent, a skill runs when it is relevant or when you call it by name; plugin installs may add a prefix.

- `/autoplan`: Runs the CEO, design, developer experience and engineering reviews in sequence and brings only taste decisions to you. (https://github.com/garrytan/gstack/tree/main/autoplan)
- `/benchmark`: Measures page load timings, Core Web Vitals and resource sizes in a real browser and compares them with a saved baseline. (https://github.com/garrytan/gstack/tree/main/benchmark)
- `/browse`: Drives a real browser, preferring your signed-in Aside sessions, to open pages, click through flows, read the console and take screenshots. (https://github.com/garrytan/gstack/tree/main/browse)
- `/canary`: Watches a live URL after a deploy for console errors, failed pages and visual changes against baseline screenshots. (https://github.com/garrytan/gstack/tree/main/canary)
- `/careful`: Warns before destructive commands such as recursive deletes, dropped tables or force pushes, and hard-blocks the riskiest ones. (https://github.com/garrytan/gstack/tree/main/careful)
- `/codex`: Gets an independent review, challenge or consultation from the OpenAI Codex CLI and presents its output unedited. (https://github.com/garrytan/gstack/tree/main/codex)
- `/cso`: Audits code, infrastructure, supply chain or skills for exploitable defects, challenges each finding and can reproduce fixes in Docker. (https://trendhub.net/skills/garrytan-gstack/cso.markdown)
- `/design-consultation`: Researches your product space and proposes a full design system, written to a DESIGN.md file with font and colour previews. (https://github.com/garrytan/gstack/tree/main/design-consultation)
- `/design-html`: Turns an approved mockup into production HTML and CSS with computed text layout, detecting React, Svelte or Vue. (https://github.com/garrytan/gstack/tree/main/design-html)
- `/design-review`: Audits a live site for spacing, hierarchy and generated-looking patterns, then fixes them with atomic commits and before and after screenshots. (https://github.com/garrytan/gstack/tree/main/design-review)
- `/design-shotgun`: Produces several AI design mockups side by side in a browser board, collects your feedback and iterates until you pick a direction. (https://github.com/garrytan/gstack/tree/main/design-shotgun)
- `/devex-review`: Tests a developer product live by following its docs and getting-started flow, timing each step and comparing against the plan's scores. (https://github.com/garrytan/gstack/tree/main/devex-review)
- `/diagram`: Turns an English description into a mermaid source, an editable Excalidraw file and rendered SVG and PNG, offline. (https://github.com/garrytan/gstack/tree/main/diagram)
- `/document-release`: Checks project docs against what changed in a release and updates the facts, asking about subjective edits. (https://github.com/garrytan/gstack/tree/main/document-release)
- `/freeze`: Blocks every file edit outside one directory you name for the rest of the session. (https://github.com/garrytan/gstack/tree/main/freeze)
- `/land-and-deploy`: Merges an approved PR, waits for CI and the deploy, then checks production health and reports the evidence. (https://github.com/garrytan/gstack/tree/main/land-and-deploy)
- `/make-pdf`: Converts a Markdown file into a typeset PDF with optional cover, table of contents and watermark, or into HTML or Word. (https://github.com/garrytan/gstack/tree/main/make-pdf)
- `/office-hours`: Questions your idea in startup or builder mode, challenges premises, compares two or three approaches and writes a design doc, with no code. (https://trendhub.net/skills/garrytan-gstack/office-hours.markdown)
- `/plan-ceo-review`: Reviews a plan as a founder would, in expansion, selective, hold or reduction mode, and asks before adding or cutting any scope. (https://trendhub.net/skills/garrytan-gstack/plan-ceo-review.markdown)
- `/plan-design-review`: Scores a plan's design dimensions from zero to ten, explains what a ten looks like and adds the missing design decisions. (https://github.com/garrytan/gstack/tree/main/plan-design-review)
- `/plan-devex-review`: Reviews a developer-facing plan for onboarding friction, error messages and time to hello world, before any code is written. (https://github.com/garrytan/gstack/tree/main/plan-devex-review)
- `/plan-eng-review`: Locks a plan's architecture, data flow, edge cases and test coverage, with ASCII diagrams and a review report appended to the plan. (https://trendhub.net/skills/garrytan-gstack/plan-eng-review.markdown)
- `/qa-only`: Explores the same surfaces as QA and reports reproducible bugs with evidence, without changing code or tests. (https://github.com/garrytan/gstack/tree/main/qa-only)
- `/qa`: Tests a site, API, CLI, job or webhook, reproduces each bug, writes a regression test first and commits each verified fix. (https://trendhub.net/skills/garrytan-gstack/qa.markdown)
- `/retro`: Summarises commits, work patterns and test health over a time window with per-contributor praise and growth areas. (https://github.com/garrytan/gstack/tree/main/retro)
- `/review`: Reviews a branch diff for bugs that pass CI, dispatches specialist and adversarial passes, auto-fixes obvious issues and asks about the rest. (https://trendhub.net/skills/garrytan-gstack/review.markdown)
- `/ship`: Merges the base branch, runs tests and reviews, bumps VERSION and CHANGELOG, verifies the frozen content, pushes and opens a PR. (https://trendhub.net/skills/garrytan-gstack/ship.markdown)
- `/spec`: Interrogates a vague request over several rounds and files a precise spec as a GitHub issue, optionally handing it to a new agent. (https://github.com/garrytan/gstack/tree/main/spec)
- `/test-audit`: Finds tests that cost more than they protect, such as duplicates or assertion-free probes, and removes them only in approved batches. (https://github.com/garrytan/gstack/tree/main/test-audit)
- `/verify`: Runs the repo's own typecheck, lint, build and selected tests, fixes failures and repeats until green, without pushing. (https://github.com/garrytan/gstack/tree/main/verify)

## Questions

### Is gstack free?

Yes. It is MIT-licensed, and the README states there is no premium tier or waitlist.

### Does it work outside Claude Code?

Yes, through ./setup --host for Codex CLI, OpenCode, Cursor, Factory Droid, Kiro, GitHub Copilot CLI, Antigravity, Gemini CLI and others, but those are marked experimental and safety hooks there are advisory rather than blocking.

### Does it send my data anywhere?

Usage telemetry stays off unless you opt in when asked. The update check contacts GitHub, and outside reviews send code to Codex or Claude; both can be turned off.

### Which platforms are supported?

macOS and Linux get full support. Windows 11 works through Git Bash or WSL with minimal support, and needs both Bun and Node.js on PATH.

## Before you install

Skills run shell commands, edit and commit code, drive a real or bundled browser, push branches, open PRs and can merge and deploy after approval; /cso runs containerised scanners through Docker. Telemetry is off unless you opt in, but an update check contacts GitHub by default and outside reviews send code to Codex or Claude.
