gstack cheat sheet

v1.91.2.0

Garry Tan's open-source software factory turns Claude Code into a virtual engineering team — 44 specialists and power tools, all free, MIT licensed. Below: every command grouped by the sprint it runs in, with one-click copy. Click any /command to copy it.

Install

Requirements: Claude Code, Git, Bun v1.0+ (and Node.js on Windows).

1. Clone & set up
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
Or paste this to Claude Code and let it do the rest
Install gstack: run `git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup` then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing, never use mcp__claude-in-chrome__* tools, and lists the available skills. Then ask if I also want to add gstack to the current project so teammates get it.
2. Team mode — auto-update for a shared repo (run from your repo)
(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"

The sprint

Think → Plan → Build → Review → Test → Ship → Reflect. Each skill feeds the next.

Think

Reframe the product before you write a line of code.
/office-hours
YC Office Hours

Six forcing questions that reframe your product. Pushes back on your framing, challenges premises, and writes a design doc that feeds every downstream skill.

Plan

Lock scope, architecture, and tests before building.
/autoplan
Review Pipeline

One command, fully reviewed plan. Runs CEO -> design -> eng -> DX automatically, auto-detects which apply, and surfaces only the taste decisions for your approval.

/plan-ceo-review
CEO / Founder

Rethink the problem. Find the 10-star product hiding inside the request. Four modes: Expansion, Selective Expansion, Hold Scope, Reduction.

/plan-eng-review
Eng Manager

Lock architecture, data flow, diagrams, edge cases, and tests. Forces hidden assumptions into the open.

/plan-design-review
Senior Designer

Rates each design dimension 0-10, shows what a 10 looks like, then edits the plan to get there. AI-slop detection. One question per design choice.

/plan-devex-review
Developer Experience Lead

Interactive DX review: personas, competitor TTHW benchmarks, your magical moment, friction tracing. Three modes, 20-45 forcing questions.

/design-consultation
Design Partner

Build a complete design system from scratch. Researches the landscape, proposes creative risks, generates realistic product mockups, writes DESIGN.md.

/spec
Spec Author

Turn vague intent into a precise, executable spec in five phases with a Codex quality gate and secret redaction. --execute spawns claude -p in a fresh worktree.

Build

Explore designs visually, then ship real HTML.
/design-shotgun
Design Explorer

Generates 4-6 AI mockup variants, opens a comparison board in your browser, collects feedback, and iterates. Taste memory learns what you pick.

/design-html
Design Engineer

Turn a mockup into production HTML/CSS with Pretext computed layout: text reflows, heights adjust. 30KB, zero deps. Detects React/Svelte/Vue.

Review

Catch the bugs that pass CI but blow up in prod.
/review
Staff Engineer

Find the bugs that pass CI but blow up in production. Auto-fixes the obvious ones, flags completeness gaps.

/codex
Second Opinion

Independent review from OpenAI Codex CLI. Three modes: pass/fail gate, adversarial challenge, open consultation. Cross-model analysis when paired with /review.

/cso
Chief Security Officer

OWASP Top 10 + STRIDE threat model. Zero-noise: 8/10+ confidence gate, independent verification, and a concrete exploit scenario per finding.

/investigate
Debugger

Systematic root-cause debugging. Iron Law: no fixes without investigation. Traces data flow, tests hypotheses, stops after 3 failed fixes.

Test

Give the agent eyes on a real browser.
/qa
QA Lead

Test your app, find bugs, fix them with atomic commits, re-verify. Auto-generates a regression test for every fix.

/qa-only
QA Reporter

Same methodology as /qa but report only. A pure bug report with no code changes.

/design-review
Designer Who Codes

The /plan-design-review audit, then fixes what it finds. Atomic commits, before/after screenshots.

/devex-review
DX Tester

Live onboarding audit: navigates docs, tries the getting-started flow, times TTHW, screenshots errors, and compares against your plan scores.

/browse
QA Engineer

Give the agent eyes: real Chromium, real clicks, real screenshots, ~100ms per command.

/benchmark
Performance Engineer

Baseline page load times, Core Web Vitals, and resource sizes. Compare before/after on every PR.

/pair-agent
Multi-Agent Coordinator

Share your browser with any AI agent (OpenClaw, Hermes, Codex, Cursor). Scoped tokens, tab isolation, rate limiting, activity attribution.

Ship

From approved to verified in production.
/ship
Release Engineer

Sync main, run tests, audit coverage, push, open the PR. Bootstraps a test framework if you do not have one.

/land-and-deploy
Release Engineer

Merge the PR, wait for CI and deploy, verify production health. One command from "approved" to "verified in production."

/canary
SRE

Post-deploy monitoring loop. Watches for console errors, performance regressions, and page failures.

Reflect

Keep docs, memory, and the team in sync.
/document-release
Technical Writer

Update every doc to match what you shipped. Builds a Diataxis coverage map so gaps show in the PR. Auto-invoked by /ship.

/document-generate
Documentation Author

Generate missing docs from scratch with the Diataxis framework after reading the codebase.

/retro
Eng Manager

Team-aware weekly retro: per-person breakdowns, shipping streaks, test-health trends. /retro global spans all projects and AI tools.

/learn
Memory

Review, search, prune, and export what gstack learned. Patterns and preferences compound across sessions.

Toolbox

Standalone power tools — pull them in whenever you need them.

Safety

/careful
Safety Guardrails

Warns before destructive commands (rm -rf, DROP TABLE, force-push). Say "be careful" to activate. Override any warning.

/freeze
Edit Lock

Restrict file edits to one directory so the agent cannot touch unrelated code while debugging.

/guard
Full Safety

/careful + /freeze in one command. Maximum safety for prod work.

/unfreeze
Unlock

Remove the /freeze boundary.

Browser

/open-gstack-browser
GStack Browser

Launch AI-controlled Chromium with sidebar, anti-bot stealth, and auto model routing (Sonnet for actions, Opus for analysis).

/connect-chrome
GStack Browser

Launch GStack Browser — Chromium with the sidebar extension baked in.

/setup-browser-cookies
Session Manager

Import cookies from your real browser (Chrome, Arc, Brave, Edge) into the headless session to test authenticated pages.

Memory & GBrain

/setup-gbrain
GBrain Onboarding

Zero to running gbrain in under 5 minutes. PGLite local, an existing Supabase URL, or auto-provision a new Supabase project.

/sync-gbrain
Keep Brain Current

Re-index this repo into gbrain and refresh the search-guidance block in CLAUDE.md. Idempotent; safe to re-run.

iOS

/ios-qa
Live-Device QA

Drive a real iPhone over USB CoreDevice. Capability-tier allowlist, per-device session lock, audit log. --tailnet exposes it to remote agents.

/ios-fix
Bug-Fix Loop

Autonomous iOS bug fixer.

/ios-design-review
HIG Audit

Designer's-eye HIG audit on real hardware.

/ios-clean
Bridge Cleanup

Remove the DebugBridge SPM package and all #if DEBUG wiring.

/ios-sync
Accessor Resync

Regenerate the iOS debug bridge against the latest upstream templates.

Setup & Maintenance

/gstack-upgrade
Self-Updater

Upgrade gstack to latest. Detects global vs vendored install, syncs both, shows what changed.

/setup-deploy
Deploy Configurator

One-time setup for /land-and-deploy. Detects your platform, production URL, and deploy commands.

Which review should I use?

Building forPlan stageLive audit
End users (UI, web, mobile)
Developers (API, CLI, SDK, docs)
Architecture (data flow, perf, tests)
All of the above—

Maintenance & troubleshooting

Upgrade to latest
cd ~/.claude/skills/gstack && git pull && ./setup
Rebuild the browser engine (if /browse fails)
cd ~/.claude/skills/gstack && bun install && bun run build
Shorter commands (drop the gstack- prefix)
cd ~/.claude/skills/gstack && ./setup --no-prefix
Uninstall
~/.claude/skills/gstack/bin/gstack-uninstall