YC 总裁 Garry Tan 开源 gstack：把 Claude Code 变成虚拟工程团队

"我想我大概从去年12月以来就没打过一行代码，基本上是这样，这是一个极其巨大的变化。" —— Andrej Karpathy，No Priors 播客，2026年3月

当我听到 Karpathy 这么说时，我想弄清楚是怎么做到的。一个人怎么能像二十人的团队一样交付？Peter Steinberger 构建了 OpenClaw —— 247K GitHub 星标 —— 基本上靠 AI 智能体单枪匹马完成。革命已经到来。一个拥有合适工具的独立构建者可以比传统团队行动得更快。

我是 Garry Tan，Y Combinator 的总裁兼 CEO。我与成千上万家初创公司合作过 —— Coinbase、Instacart、Rippling —— 那时它们还只是车库里的一两个人。在 YC 之前，我是 Palantir 最早的工程师/产品经理/设计师之一，联合创立了 Posterous（被 Twitter 收购），并构建了 Bookface，YC 的内部社交网络。

gstack 就是我的答案。 我已经做了二十年产品，而现在我交付的产品比以往任何时候都多。在过去 60 天里：3 个生产服务，40+ 已交付功能，兼职完成，同时全职运营 YC。按逻辑代码变更计算 —— 不是 AI 会虚增的原始代码行数 —— 我 2026 年的速率是 2013 年节奏的约 810 倍（11,417 对 14 逻辑行/天）。年初至今（截至 4 月 18 日），2026 年已经产出了 2013 年全年的 240 倍。在包括 Bookface 在内的 40 个公开 + 私有 garrytan/* 仓库中测量，排除一个演示仓库后。AI 写了其中大部分。重点不是谁打的字，而是交付了什么。

代码行数批评者说得没错，原始行数会因 AI 而虚增。但他们错了的是，按通胀归一化后，我的生产力更低。我的生产力更高，而且高得多。完整方法论、注意事项和复现脚本：关于代码行数争议。

2026 年 —— 1,237 次贡献且仍在增加：

2013 年 —— 我在 YC 构建 Bookface 时（772 次贡献）：

同一个人。不同的时代。区别在于工具。

gstack 就是我做到这一点的方式。 它把 Claude Code 变成一个虚拟工程团队 —— 一个重新思考产品的 CEO，一个锁定架构的工程经理，一个捕捉 AI 垃圾的设计师，一个发现生产 bug 的审查者，一个打开真实浏览器的 QA 负责人，一个运行 OWASP + STRIDE 审计的安全官，以及一个交付 PR 的发布工程师。二十三个专家和八个强大工具，全是斜杠命令，全是 Markdown，全部免费，MIT 许可证。

这是我的开源软件工厂。我每天都用它。我分享它是因为这些工具应该对所有人可用。

Fork 它。改进它。让它成为你的。如果你想吐槽免费开源软件 —— 欢迎，但我更希望你先试试。

这是给谁的：

• 创始人和 CEO —— 尤其是仍然想交付的技术型创始人
• 首次使用 Claude Code 的用户 —— 结构化的角色，而不是空白提示
• 技术负责人和资深工程师 —— 每个 PR 上都有严格的审查、QA 和发布自动化

快速开始

1. 安装 gstack（大约 30 秒的设置 —— 见下文）
2. 运行 /office-hours —— 描述你正在构建的内容
3. 对任何功能想法运行 /plan-ceo-review
4. 对任何有变更的分支运行 /review
5. 在你的 staging URL 或隔离的本地 API、CLI、任务或 webhook 上运行 /qa
6. 到此为止。你会知道这是否适合你。

安装 —— 大约 30 秒

./setup 在 4 核 vCPU 的 Linux 云主机上克隆后耗时 31 秒（v1.91.13.0，干净的 HOME，包括二进制构建和 Chromium 下载）。网络较慢和笔记本电脑上耗时更长。

要求： Claude Code、Git、Bun v1.0+、Node.js（仅 Windows）。macOS 上推荐： Aside 浏览器（macOS 15+）——浏览器技能、/make-pdf 和 /diagram 会优先驱动它，并使用你真实登录的会话。没有它时，./setup 会构建 gstack 自带的浏览器，同样的技能会使用那个。/cso 还需要一个带有全部四个 --no-compile-autoload-* 构建标志的 Bun 版本以及原生工具链：Linux 上支持静态编译的 C 编译器，macOS 上的 Xcode 命令行工具，或 Windows 上带有使用 C++ 的桌面开发的 Visual Studio 2022 Build Tools。如果这些不存在，安装程序会安装其他所有内容，移除过时的 CSO 辅助程序，并且 /cso 会报告 not assessed 以及该先决条件。

当合格的 CSO 运行时镜像发布后，安装程序会为每个自动预加载提供 30 秒窗口，外加针对所声明目录的有界安装配额。对于较慢的注册表，请设置一个整数，例如 GSTACK_CSO_IMAGE_PULL_TIMEOUT_SECONDS=120（可接受范围：5–300 秒）。一个镜像超时不会消耗其余镜像的窗口；安装程序会报告部分进度，后续运行会从本地 Docker 中已存在的精确摘要继续。完整预加载上限为一小时。

第 1 步：在你的机器上安装

打开 Claude Code 并粘贴此内容。Claude 会完成其余工作。

安装 gstack：运行 git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup，然后在 CLAUDE.md 中添加一个“gstack”部分，说明所有网页浏览都使用 gstack 的 /browse 技能，绝不使用 mcp__claude-in-chrome__* 工具，并列出可用技能：/office-hours、/plan-ceo-review、/plan-eng-review、/plan-design-review、/design-consultation、/design-shotgun、/design-html、/review、/deslop-shared-libs、/test-audit、/ship、/land-and-deploy、/canary、/benchmark、/browse、/connect-chrome、/qa、/qa-only、/design-review、/scrape、/setup-browser-cookies、/setup-deploy、/setup-gbrain、/retro、/investigate、/document-release、/document-generate、/codex、/cso、/autoplan、/plan-devex-review、/devex-review、/careful、/freeze、/guard、/unfreeze、/gstack-upgrade、/learn。然后询问用户是否也想将 gstack 添加到当前项目，以便队友也能获得它。

第 2 步：团队模式——共享仓库的自动更新（推荐）

在你的仓库内粘贴此内容。它会将你切换到团队模式，引导仓库以便队友自动获得 gstack，并提交更改：

(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"

你的仓库中没有 vendored 文件，没有版本漂移，无需手动升级。每个 Claude Code 会话开始时都会进行快速的自动更新检查（限制为每小时一次，网络故障安全，完全静默）。

如果你更倾向于提醒队友而不是阻止他们，请将 required 替换为 optional。

OpenClaw

OpenClaw 通过 ACP 生成 Claude Code 会话，因此当 Claude Code 安装了 gstack 时，每个 gstack 技能都能直接使用。将此内容粘贴到你的 OpenClaw 代理：

安装 gstack：运行 git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup 为 Claude Code 安装 gstack。然后在 AGENTS.md 中添加一个“Coding Tasks”部分，内容为：当为编码工作启动 Claude Code 会话时，告诉该会话使用 gstack 技能。包含以下示例——安全审计：“Load gstack. Run /cso”，代码审查：“Load gstack. Run /review”，对 URL 进行 QA 测试：“Load gstack. Run /qa https://...”，端到端构建功能：“Load gstack. Run /autoplan, implement the plan, then run /ship”，先规划再构建：“Load gstack. Run /office-hours then /autoplan. Save the plan, don't implement.”

设置完成后，只需自然地与你的 OpenClaw agent 对话：

有关高级调度路由以及 gstack-lite/gstack-full 提示模板，请参阅 docs/OPENCLAW.md。

原生 OpenClaw 技能（通过 ClawHub）

四个方法论技能，可直接在你的 OpenClaw agent 中运行，无需 Claude Code 会话。从 ClawHub 安装：

clawhub install gstack-openclaw-office-hours gstack-openclaw-ceo-review gstack-openclaw-investigate gstack-openclaw-retro

这些是对话式技能。你的 OpenClaw agent 会直接通过聊天运行它们。

其他 AI Agents

gstack 可在比 Claude 更多的 agent 上运行。裸 ./setup 安装仅适用于 Claude Code。使用 --host <name> 选择另一个 agent，或使用 --host auto 为这台机器上检测到的每个 agent 安装：

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

显式 --host X 仅为 X 安装，且绝不会更改另一个 agent 的安装。/gstack-upgrade 会刷新它注册的每个安装，每个主机一行，并说明哪些失败了。

层级：full 已通过真实工作流运行认证（参见 Certify your host）；experimental 可安装并通过一致性测试，但尚无认证运行；instruction-only 不安装任何内容：设置会打印需要复制的内容。

Copilot 通过带前缀的名称调用 gstack 技能（/gstack-review），因为 /review 是 Copilot 的内置功能。Copilot 会忽略技能钩子，所以 /careful 和 /freeze 在那里只能提供建议，并且除 ~/.copilot 之外的 COPILOT_HOME 尚不受支持（setup 会拒绝且不做任何更改）。

外部评审要求所选的 CLI 已安装并完成身份验证：在 Codex 中使用 gstack 时是 Claude Code，在其他 harness 上是 Codex。外部 harness 将这些命令识别为 /gstack-claude-code 和 /gstack-codex；每个 harness 都会省略自己的包装器。显式指定 provider 的请求会保留该 provider。现有的 codex_reviews 设置会在支持的情况下控制自动外部评审，无论选择的是哪个 provider。

/claude 已重命名为 /claude-code。重新运行 ./setup --host <name> 以迁移受管理的安装，包括共享该 checkout 的其他 harness。如果替换生成或安装失败，setup 会保留先前的安装并打印修复说明。

仅指令层级（任何读取规则的 agent——Zed、Amp、Jules、副项目）： 将 2KB 摘要复制到 agents-digest/gstack-AGENTS.md 你的 agent 会读取的位置（例如，将其追加到项目的 AGENTS.md 中）。 它承载了 gstack 的理念、复用阶梯和语气规则——无需安装。该 摘要的第一行显示其 gstack 版本；升级后请重新复制。

对于 Codex，setup 会从 ${CODEX_HOME:-~/.codex}/config.toml 读取顶层 model 并生成匹配的行为 配置，当未配置可用模型时回退到 gpt-6-astra。 gpt-5.6-sol 会自动接收有界范围的指令， 完成所请求的 lake，而不会扩展到相邻的清理或推测性的 加固。Sol 配置仅支持精确匹配：带日期的快照和其他 5.6 变体会获得通用 GPT 配置，setup 会对类似 gpt-5.6-sol-2026-08-01 的近似情况发出警告。使用 ./setup --host codex --model <id> 覆盖检测——该 覆盖仅适用于该次运行；在你的 Codex config.toml 中设置 model 以 使其在升级后持续生效。更改 Codex 模型后，重新运行 ./setup --host codex 以重新生成技能。

gstack 使用哪个 Codex 模型。对于每次 Codex 调用（外部声音、 /codex、review 和 ship 对抗性检查），gstack 按以下 顺序选择模型：你为该请求指定的模型，然后是 GSTACK_CODEX_MODEL，然后是 你的 Codex config.toml 中的 model（对于原生 codex review，优先 review_model； 自定义 CODEX_HOME 会被采用），最后才是 gstack 的默认值 gpt-6-astra。在花费任何资源之前，它会打印所选模型及其来源， 例如 CODEX_MODEL: gpt-5.6-terra (exec; source: ~/.codex/config.toml model)。 如果你的选择无效或你的账户无法使用它，gstack 会停止并给出 修复消息，并报告外部评审不可用。它绝不会静默 切换到默认值。嵌套的 Codex 评审也会在隐藏已安装技能的情况下运行（-c skills.include_instructions=false），因此评审不会变成 完整的嵌套技能运行。运行时模型选择与上述 setup 时的 行为配置是分开的。/claude-code（在 Codex 上是 gstack-claude-code） 保留 Claude 配置的模型。设置 GSTACK_CLAUDE_MODEL=<model> 或在请求中指定模型以在本次调用中覆盖它，包括 恢复的咨询。有关 capture、judge 和 benchmark 模型选择，请参阅 eval 默认值与覆盖。

设计二进制文件（$D）默认使用 OpenAI 的 gpt-5.5，图像 生成通过 gpt-image-2 完成。设置 GSTACK_DESIGN_MODEL=<model> 以在图像生成和截图分析中 使用另一个 gpt-5 级模型；如果 OpenAI 拒绝它，错误会指明 GSTACK_DESIGN_MODEL。使用 bun run design/scripts/live-model-check.ts 对照默认值检查密钥。

想添加对另一个 agent 的支持？请参阅 docs/ADDING_A_HOST.md。 渲染一个新 agent 只需一个 TypeScript 配置文件；安装它还需要一个 setup 分支和一致性套件，并且它最初是实验性的。

看它运行

You:    I want to build a daily briefing app for my calendar.
You:    /office-hours
Claude: [asks about the pain — specific examples, not hypotheticals]

You:    Multiple Google calendars, events with stale info, wrong locations.
        Prep takes forever and the results aren't good enough...

Claude: I'm going to push back on the framing. You said "daily briefing
        app." But what you actually described is a personal chief of
        staff AI.
        [extracts 5 capabilities you didn't realize you were describing]
        [challenges 4 premises — you agree, disagree, or adjust]
        [generates 3 implementation approaches with effort estimates]
        RECOMMENDATION: Ship the narrowest wedge tomorrow, learn from
        real usage. The full vision is a 3-month project — start with
        the daily briefing that actually works.
        [writes design doc → feeds into downstream skills automatically]

You:    /plan-ceo-review
        [reads the design doc, challenges scope, runs 10-section review]

You:    /plan-eng-review
        [ASCII diagrams for data flow, state machines, error paths]
        [test matrix, failure modes, security concerns]

You:    Approve plan. Exit plan mode.
        [writes 2,400 lines across 11 files. ~8 minutes.]

You:    /review
        [AUTO-FIXED] 2 issues. [ASK] Race condition → you approve fix.

You:    /qa https://staging.myapp.com
        [opens real browser, clicks through flows, finds and fixes a bug]

You:    /ship
        Tests: 42 → 51 (+9 new). PR: github.com/you/app/pull/42

你说的是“每日简报应用”。Agent 说的是“你在打造一个幕僚长 AI”——因为它倾听的是你的痛点，而不是你的功能需求。八条命令，端到端。那不是 copilot。那是一支团队。

冲刺

gstack 是一套流程，而不是一堆工具的集合。这些技能按照冲刺运行的顺序依次执行：

思考 → 规划 → 构建 → 评审 → 测试 → 发布 → 反思

每项技能都衔接下一项。/office-hours 编写设计文档，/plan-ceo-review 读取它。/plan-eng-review 编写测试计划，/qa 接手执行。/review 捕获 bug，/ship 验证它们已被修复。没有任何环节会遗漏，因为每一步都清楚前面发生了什么。

没有网页时的 QA

对浏览器和非浏览器软件使用相同的命令。在一个仓库中开始， 使用其文档化的原生命令和隔离的本地 fixture；指明目标 以及你想检查的行为。例如：

/qa-only Test this repo's CLI using its documented local fixture. Check valid and invalid input, exit codes, stdout/stderr, and cancellation. Report only; do not change code or tests. For each finding, include the exact command, expected and actual results, and which checks remain untested. Keep requests inside the fixture; ask before contacting an external service.

/qa Test this repo's local webhook and worker fixture. Explore duplicate deliveries and recovery after a partial failure. Keep all effects inside the fixture; preserve reproduced bugs in native regression tests before repairing them.

QA 首先会告诉你它将使用哪个界面、哪些工具和写入权限。CLI 或 API 不需要浏览器。浏览器目标保留真实浏览器测试；开发者 体验审计仅在入职、安装或人体工学在范围内时才加载。 如果原生工具或安全 fixture 不可用，报告会指明阻塞项 和未测试的契约，而不是编造一个通过结果或安装另一个框架。

探索意味着从每个结果中学习并选择下一个有用的挑战，而不是运行随机命令。在下一次发现探测之前，QA 会保存一份简短的 exploration-NNN.json 证据记录，包含上一个结果、正在测试的假设以及下一条命令。最终报告会链接这些记录；它们不需要在探测之间额外发送聊天消息。发现的 bug 必须可复现，其新测试必须在修复前对 bug 失败、修复后通过。单元测试保护逻辑；集成测试和端到端测试保护 mock 会掩盖的真实边界。/qa-only 提出这些测试而不编写它们。

普通 /review 和 /ship 会自动对变更行为及附近风险运行有界版本，包括没有计划或 Web 服务器的小型 diff。现有的修复/测试审批规则仍然适用。缺失依赖、被拒绝的操作和时间限制仍然是可见的覆盖缺口；短暂的冒烟测试绝不意味着详尽的 QA。生产环境访问以及破坏性或外部影响需要特定权限。

有界探索使用可执行的截止时间守卫，而不是估算时钟：它拒绝迟到的探测，并在限制处停止所拥有的前台工作。未完成的检查在报告中保持可见。必需的计划检查仍处于审查/发布冒烟预算之外。有关命令、平台和清理限制，请参阅 QA 截止时间。

每次发布还会运行现有的文档审计，包括重复发布和现有 PR 更新。清晰的事实性更正会加入最终检查的变更；有风险的改写需要审批。审计失败会停止以进行恢复或明确接受所指定的风险，而不是静默丢弃其结果。发布负责版本控制、Git 和 PR 发布；文档助手不会独立提交或推送。

我应该使用哪种审查？

强力工具

独立二进制文件

除了斜杠命令技能之外，gstack 还为不适合在会话内运行的工作流提供了独立 CLI：

私有付费 CSO 评估生产者是一份打包契约，而不是普通的 bun run build 产物。在 macOS 或 Linux 上，发布操作员在与 bun run build:cso 相同的干净构建会话中，使用文档化的加固 Bun 标志编译 cso-eval-producer，然后将其与 gstack-cso-launcher、gstack-cso-core、gstack-cso-watchdog 以及隐藏的 .gstack-cso-generation 清单一起安装为一个 root 所有、不可写的五产物单元。生产者拒绝 root 执行、可写/符号链接/不完整的安装以及未经审查的提供商 CLI 版本；每份回执绑定全部五个产物哈希，收集时拒绝来自不同单元身份的回执。参见 干净生产者流程。付费生产者评估在 Windows 上仍不可用，因为分离式看门狗没有 Windows 构建。

每个生产者获得一份精选的单单元源代码副本，目录权限封为 0555，文件权限封为 0444，外加前后内容、Git 和模式检查。Claude 将该精确副本作为受限的只读附加目录接收，以便其受限的启动器命令可以访问它。Gemini 不接收源代码工作目录或包含目录。Codex 在技术上获得对精确精选源代码根的只读文件系统访问权限，因为受信任的辅助程序继承了 Codex 权限配置文件；其私有提供商工作目录和精确的 cso-home 产物目录是唯一的写入根，所有其他根路径仍被拒绝，并且生产者提示要求通过辅助程序访问源代码。这是针对不可变公共夹具的评估隔离，并非声称 Codex 无法直接读取该夹具。

将每个已完成单元格的回执连同 state/cso-home/security/cso/ 复制到受信任的裁决主机。回执条目是相对于该目录的排序路径，并绑定每个保留文件的大小和 SHA-256 以及一个聚合清单哈希。提供方主目录、设置、会话和凭据位于单独的一次性目录下，并在单元格结束后删除；它们从不属于保留的产物树。裁决者必须在信任报告或修复包之前，根据回执对传输过来的树重新计算哈希。

付费生产者资格使用以下明确的主机矩阵：

每个因设置受阻的综合单元格在发布门禁分母中仍计为未命中。当某个主机或工作流的隔离策略阻止所需设置时，评估器不会静默地将其计为受支持。

./setup 还在 ~/.claude/settings.json 中注册一个默认开启的 Stop 钩子： gstack-timeline-stop（在会话被中断时关闭悬空的会话时间线条目；失败开放——2 秒内部预算，始终以 0 退出，永远不会阻塞会话）。使用 ./setup --no-timeline-stop-hook 持久选择退出——该选择会写入 timeline_stop_hook 配置键，在升级后仍然保留，并且明确的“否”会移除一个活动注册。GSTACK_TIMELINE_STOP_HOOK=no 和 gstack-config set timeline_stop_hook no 也可以（标志 > 环境变量 > 配置）。 ./setup --no-team 在该次运行中跳过它，gstack-settings-hook remove-source --source gstack-timeline-stop 手动移除它，gstack-uninstall 也会移除它。

钩子注册仅限规范路径：每个钩子命令都指向稳定的 ~/.claude/skills/gstack 安装，而绝不是运行树设置所在的目录，因此删除工作树或 Conductor 工作区不会在你的会话中留下报错的死钩子。每次 ./setup 运行也会先进行修复：gstack-settings-hook prune-stale --repoint 移除失效的 gstack 钩子条目，将过时的条目重新指向稳定安装，并合并重复项，仅在发生更改时打印一行（并在文件旁写入备份）。

领域技能 + 原始 CDP 逃生舱

gstack 自有引擎中的两个浏览器原语（当 Aside 不在时的回退路径）会随时间增强代理：

• $B domain-skill save —— 代理保存每个站点的笔记（例如，“LinkedIn 的 Apply 按钮位于 iframe 中”），下次访问该主机名时自动触发。隔离 → 3 次成功使用后激活 → 可通过 $B domain-skill promote-to-global 可选跨项目提升。存储与 /learn 的每项目学习文件放在一起。完整参考：docs/domain-skills.md。
• $B cdp <Domain.method> —— 原始 Chrome DevTools Protocol 逃生舱，用于精选命令遗漏的罕见情况。默认拒绝：方法必须显式添加到 browse/src/cdp-allowlist.ts 并附一行理由。两级互斥锁将浏览器范围的 CDP 调用与每标签页工作串行化。数据外泄方法的输出被包裹在 UNTRUSTED 信封中。

想要没有约束、没有允许列表、没有守护进程的原生 CDP——只是从 agent 到 Chrome 的轻量传输？browser-use/browser-harness-js 是另一种理念（由 agent 编写辅助工具，而非 gstack 的精选命令），如果你不想要 gstack 的安全栈，它会很合适。两者可以共存：gstack 的 $B cdp 和 harness 都可以通过 Playwright 的 newCDPSession 连接到同一个 Chrome。

每个技能的深度解析、示例与理念 →

Karpathy 的四种失败模式？已经覆盖了。

Andrej Karpathy 的 AI 编码规则（17K stars）点明了四种失败模式：错误假设、过度复杂、正交编辑、命令式优于声明式。gstack 的工作流技能对四者都有约束。/office-hours 在写代码之前把假设摆到明面上。Confusion Protocol 阻止 Claude 在架构决策上瞎猜。/review 捕捉不必要的复杂性和顺手乱改。/ship 把任务转化为可验证的目标，并采用测试先行的执行方式。如果你已经在用 Karpathy 风格的 CLAUDE.md 规则，gstack 就是让它们在整个 sprint 中持续生效的工作流执行层，而不只是单次提示。

并行 sprint

gstack 跑一个 sprint 没问题。同时跑十个就变得有意思了。

设计是核心。/design-consultation 从零构建你的设计系统，调研现有方案，提出创意风险，并编写 DESIGN.md。但真正的魔力在于 shotgun-to-HTML 流水线。

/design-shotgun 是你探索的方式。你描述你想要什么。它用 GPT Image 生成 4-6 个 AI 模型变体。然后在浏览器中打开一个对比面板，把所有变体并排展示。你挑选喜欢的，留下反馈（“多点留白”、“标题更大胆”、“去掉渐变”），它再生成新一轮。重复直到你满意为止。几轮之后品味记忆就会生效，开始偏向你真正喜欢的东西。不用再用文字描述你的构想，然后指望 AI 能理解。你看到选项，挑出好的，然后可视化地迭代。

与 impeccable 兼容。如果你也在用 impeccable，gstack 不会与它冲突。当你安装了 impeccable 时，gstack 会在 /design-review、/review、/ship 和 /design-html 中把 impeccable 的确定性引擎作为前置步骤运行（gstack 从不运行 impeccable 的安装器或启动器；设计技能第一次找不到引擎时，它会询问一次是否将引擎二进制文件下载到 ~/.impeccable，带校验和锁定并记录日志，并记住你的回答），用它自己的方式说出相同的 61 个规则 id，读取 PRODUCT.md，以两个工具都能读取的开放 DESIGN.md 格式写入 DESIGN.md，并把延迟处理的问题交给 /impeccable <command>。说“不”则一切不变：不唠叨，不缺失步骤。gstack-config set design_detector off 可关闭前置步骤。gstack 从 impeccable 和 DESIGN.md 规范中衍生出的材料的署名在 NOTICE.md 中。

/design-html 让它成真。把那个已批准的模型（来自 /design-shotgun、CEO 计划、设计评审，或仅仅是一段描述）变成生产级 HTML/CSS。不是那种在一个视口宽度下看起来还行、换个地方就崩掉的 AI HTML。它使用 Pretext 进行文本计算布局：文本在调整大小时真正重排，高度随内容调整，布局是动态的。30KB 开销，零依赖。它会检测你的框架（React、Svelte、Vue）并输出正确的格式。智能 API 路由会根据是落地页、仪表盘、表单还是卡片布局，选择不同的 Pretext 模式。输出的是你真正会发布的东西，而不是演示。

/qa 是一次巨大的解放。它让我从 6 个并行 worker 扩展到 12 个。Claude Code 说出 "I SEE THE ISSUE"，然后真正修复它、生成回归测试并验证修复——这改变了我的工作方式。Agent 现在有眼睛了。

智能审查路由。就像在一家运营良好的创业公司里：CEO 不必查看基础设施 bug 修复，后端改动也不需要设计审查。gstack 会跟踪运行了哪些审查，判断什么是合适的，然后直接做聪明的事。Review Readiness Dashboard 会在你发布前告诉你处于什么状态。

测试一切。如果你的项目没有测试框架，/ship 会从零开始搭建。每次 /ship 运行都会生成覆盖率审计。/qa 在基础设施可用时创建原生回归测试，并明确报告缺失的测试覆盖；仅 CSS 的修复可以改用浏览器证据。100% 测试覆盖率是目标——测试让 vibe coding 变得安全，而不是 yolo coding。

/document-release 就是你从未拥有过的工程师。它会根据发布 diff 审计相关的已撰写文档，并在最终验证前纠正事实偏差。有风险的更改会返回等待批准。/ship 在每次运行时调用它，并负责 TODOS、发布元数据、生成和发布；子进程报告文档已更新、当前或受阻。

Aside 是 gstack 首先驱动的浏览器。对于浏览器界面，在 Mac 上打开 Aside AI 浏览器时，/qa、/qa-only、/design-review、/canary、/benchmark、/scrape 和 /browse 都在那里运行——你的真实浏览器，带着你真实登录的会话，在 agent 为自己打开并在完成后关闭的标签页中。无需导入 cookie，没有“打开浏览器”步骤，没有 CAPTCHA 交接的麻烦：遇到登录墙，在 Aside 内登录，说“完成”，agent 就会继续。页面返回的任何内容都被视为不可信内容——agent 从中获取语法，绝不获取指令。/make-pdf、/diagram 和设计预览也通过 Aside 打印和截图（从你机器上的 loopback 提供服务，每个脚本渲染一次），规划技能在求助于搜索工具之前，会通过 Aside 自己的 agent 进行网络研究。

当 Aside 不在时，gstack 自己的浏览器会自动接管。Linux、Windows，或关闭了 Aside 的 Mac：相同的技能使用 ./setup 构建的捆绑无头 Chromium，产生相同的证据，并点亮下面那些只有在浏览器属于 gstack 而非你时才有的功能。

真实浏览器模式。/open-gstack-browser 启动 GStack Browser，一个 AI 控制的 Chromium，具有反机器人隐身、自定义品牌，并内置侧边栏扩展。Google 和 NYTimes 等网站无需验证码即可使用。菜单栏显示“GStack Browser”而不是“Chrome for Testing”。你的常规 Chrome 保持原样。所有现有的浏览命令照常工作。$B disconnect 返回无头模式。只要窗口打开，浏览器就保持存活……没有空闲超时在你工作时将其杀死。

侧边栏代理——你的 AI 浏览器助手。在 Chrome 侧边栏中输入自然语言，一个子 Claude 实例会执行它。“导航到设置页面并截图。”“用测试数据填写这个表单。”“遍历这个列表中的每一项并提取价格。”侧边栏会自动路由到合适的模型：Sonnet 用于快速操作（点击、导航、截图），Opus 用于阅读和分析。每个任务最多 5 分钟。侧边栏代理在隔离会话中运行，因此不会干扰你的主 Claude Code 窗口。侧边栏页脚支持一键导入 cookie。

个人自动化。侧边栏代理不仅适用于开发工作流。例如：“浏览我孩子学校的家长门户，把所有其他家长的姓名、电话号码和照片添加到我的 Google 通讯录中。”有两种方式完成身份验证：(1) 在有头浏览器中登录一次，你的会话会保持，或 (2) 点击侧边栏页脚中的“cookies”按钮，从你真实的 Chrome 中导入 cookie。一旦通过验证，Claude 会浏览目录、提取数据并创建联系人。

提示注入防御。恶意网页会试图劫持你的侧边栏代理。gstack 提供分层防御：每次读取页面时进行内容过滤（数据标记、隐藏元素剥离、ARIA 清理、URL 黑名单），外加一个 22MB 的 ML 分类器在 sidecar 子进程中本地运行，在代理看到页面衍生内容之前进行扫描，并有一个裁决合并器要求分类器一致同意才阻止（防止对 Stack Overflow 风格指令页面的单模型误报）。一切都在你的机器上运行，无网络调用。紧急终止开关：GSTACK_SECURITY_OFF=1。完整技术栈见 ARCHITECTURE.md。

AI 卡住时的浏览器交接。遇到 CAPTCHA、认证墙或 MFA 提示？$B handoff 会在完全相同的页面打开一个可见的 Chrome，你的所有 cookie 和标签页都完好无损。解决问题后，告诉 Claude 你完成了，$B resume 会从它中断的地方继续。代理甚至在连续 3 次失败后会自动建议这样做。

/pair-agent 是跨代理协调。你在使用 Claude Code。你同时运行着 OpenClaw。或者 Hermes。或者 Codex。你想让它们都查看同一个网站。输入 /pair-agent，选择你的代理，一个 GStack Browser 窗口会打开，这样你可以观看。该技能会打印一段指令。将那段指令粘贴到另一个代理的聊天中。它会用一次性设置密钥换取会话令牌，创建自己的标签页，并开始浏览。你可以看到两个代理在同一个浏览器中工作，各自在自己的标签页中，互不干扰。如果安装了 ngrok，隧道会自动启动，这样另一个代理可以在一台完全不同的机器上。同一台机器上的代理会获得一个零摩擦快捷方式，直接写入凭据。这是不同厂商的 AI 代理首次能够通过共享浏览器进行协调，并具备真正的安全性：作用域令牌、标签页隔离、速率限制、域名限制和活动归属。

Multi-AI second opinion. In Codex, gstack sends outside reviews to Claude Code through /claude-code. In Claude Code, /codex sends them to OpenAI Codex. Other harnesses expose both skills and use Codex where automatic outside reviews are supported. Each skill supports code review, adversarial challenge, and consultation with session continuity. Routing follows the harness, so changing your configured model does not change the outside reviewer. Reports identify the provider that actually completed each review; unavailable outside coverage remains visible.

Safety guardrails on demand. Say "be careful" and /careful warns before any destructive command — rm -rf, DROP TABLE, force-push, git reset --hard. /freeze locks edits to one directory while debugging so Claude can't accidentally "fix" unrelated code. /guard activates both. /investigate auto-freezes to the module being investigated.

Proactive skill suggestions. gstack notices what stage you're in — brainstorming, reviewing, debugging, testing — and suggests the right skill. Don't like it? Say "stop suggesting" and it remembers across sessions.

10-15 parallel sprints

gstack is powerful with one sprint. It is transformative with ten running at once.

Conductor runs multiple Claude Code sessions in parallel — each in its own isolated workspace. One session running /office-hours on a new idea, another doing /review on a PR, a third implementing a feature, a fourth running /qa on staging, and six more on other branches. All at the same time. I regularly run 10-15 parallel sprints — that's the practical max right now.

The sprint structure is what makes parallelism work. Without a process, ten agents is ten sources of chaos. With a process — think, plan, build, review, test, ship — each agent knows exactly what to do and when to stop. You manage them the way a CEO manages a team: check in on the decisions that matter, let the rest run.

Voice input (AquaVoice, Whisper, etc.)

gstack skills have voice-friendly trigger phrases. Say what you want naturally — "run a security check", "test the website", "do an engineering review" — and the right skill activates. You don't need to remember slash command names or acronyms.

Uninstall

Option 1: Run the uninstall script

If gstack is installed on your machine:

~/.claude/skills/gstack/bin/gstack-uninstall

This handles skills, symlinks, global state (~/.gstack/), project-local state, browse daemons, and temp files. Use --keep-state to preserve config and analytics. Use --force to skip confirmation.

Option 2: Manual removal (no local repo)

If you don't have the repo cloned (e.g. you installed via a Claude Code paste and later deleted the clone):

# 1. Stop browse daemons
pkill -f "gstack.*browse" 2>/dev/null || true

# 2. Remove per-skill directories whose SKILL.md points into gstack/
#    (rm -rf, not rmdir — installed dirs also contain runtime-asset links)
find ~/.claude/skills -mindepth 1 -maxdepth 1 -type d ! -name gstack 2>/dev/null |
while IFS= read -r dir; do
  link="$dir/SKILL.md"
  [ -L "$link" ] || continue
  target=$(readlink "$link" 2>/dev/null) || continue
  case "$target" in
    gstack/*|*/gstack/*)
      rm -rf "$dir"
      ;;
  esac
done
# Directories gstack created carry a .gstack-owned marker (the only signal on
# Windows, where installs are file copies with no symlink to read)
for marker in ~/.claude/skills/*/.gstack-owned; do
  [ -f "$marker" ] && rm -rf "$(dirname "$marker")"
done
# Alias skills install as copies (no symlink to detect) — remove by name
rm -rf ~/.claude/skills/_gstack-command ~/.claude/skills/connect-chrome 2>/dev/null

# 3. Remove gstack
rm -rf ~/.claude/skills/gstack

# 4. Remove global state
rm -rf ~/.gstack

# 5. Remove integrations (skip any you never installed)
rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/gstack"* 2>/dev/null
rm -rf ~/.factory/skills/gstack* 2>/dev/null
rm -rf ~/.kiro/skills/gstack* 2>/dev/null
rm -rf ~/.openclaw/skills/gstack* 2>/dev/null
rm -rf ~/.cursor/skills/gstack* 2>/dev/null
rm -rf ~/.config/opencode/skills/gstack* 2>/dev/null

# 6. Remove temp files
rm -f /tmp/gstack-* 2>/dev/null

# 7. Per-project cleanup (run from each project root)
rm -rf .gstack .gstack-worktrees .claude/skills/gstack 2>/dev/null
rm -rf .agents/skills/gstack* .factory/skills/gstack* 2>/dev/null

Manual removal leaves gstack's hook entries behind in ~/.claude/settings.json (the uninstall script removes all of them for you, including entries whose _gstack_source tag was stripped). Edit that file and delete every hook whose command path points into .claude/skills/gstack/: the SessionStart auto-update hook, the AskUserQuestion PreToolUse/PostToolUse hooks, and the Stop hooks (session timeline, plus verify-gate if you opted in). Left in place, they error on every matching event once the install directory is gone.

Clean up CLAUDE.md

The uninstall script does not edit CLAUDE.md. In each project where gstack was added, remove the ## gstack and ## Skill routing sections.

Playwright

~/Library/Caches/ms-playwright/ (macOS) is left in place because other tools may share it. Remove it if nothing else needs it.

Aside

gstack never installed Aside, so it never uninstalls it. Keep it or remove it like any other app.

Free, MIT licensed, open source. No premium tier, no waitlist.

I open sourced how I build software. You can fork it and make it your own.

We're hiring. Want to ship real products at AI-coding speed and help harden gstack? Come work at YC — ycombinator.com/software Extremely competitive salary and equity. San Francisco, Dogpatch District.

GBrain — persistent knowledge for your coding agent

GBrain is a persistent knowledge base for AI agents — think of it as the memory your agent actually keeps between sessions. GStack gives you a one-command path from zero to "it's running, my agent can call it."

/setup-gbrain

Four paths, pick one:

• Supabase, existing URL — your cloud agent already provisioned a brain; paste the Session Pooler URL, now this laptop uses the same data.
• Supabase, auto-provision — paste a Supabase Personal Access Token; the skill creates a new project, polls to healthy, fetches the pooler URL, hands it to gbrain init. ~90 seconds end-to-end.
• PGLite local — zero accounts, zero network, ~30 seconds. Isolated brain on this Mac only. Great for try-first; migrate to Supabase later with /setup-gbrain --switch.
• Remote gbrain MCP — your brain runs on another machine (Tailscale, ngrok, internal LAN) or a teammate's server; paste an MCP URL and bearer token. Optionally pair with a local PGLite for symbol-aware code search in split-engine mode. Best for cross-machine memory without standing up a local DB.

After init, the skill offers to register gbrain as an MCP server for Claude Code (claude mcp add gbrain -- gbrain serve) so gbrain search, gbrain put, etc. show up as first-class typed tools — not bash shell-outs.

Keeping the brain current. Run /sync-gbrain from any repo to re-index its code into gbrain (incremental by default, --full for a full reindex, --dry-run to preview). The skill registers the cwd as a federated source via gbrain sources add, runs gbrain sync --strategy code, and writes a ## GBrain Search Guidance block to your project's CLAUDE.md so the agent prefers gbrain search/code-def/code-refs over Grep. The block is removed automatically if the capability check fails — no stale guidance pointing at tools that aren't installed.

Per-remote trust policy. Each repo on your machine gets one of three tiers:

• read-write — agent can search the brain AND write new pages back from this repo
• read-only — agent can search but never writes (best for multi-client consultants: search the shared brain, don't contaminate it with Client A's work while in Client B's repo)
• deny — no gbrain interaction at all

The skill asks once per repo. The decision is sticky across worktrees and branches of the same remote.

GStack memory sync (different feature, same private-repo infra). Optionally pushes your gstack state (learnings, CEO plans, design docs, retros, developer profile) to a private git repo so your memory follows you across machines, with a one-time privacy prompt (everything allowlisted / artifacts only / off) and a defense-in-depth secret scanner that blocks AWS keys, tokens, PEM blocks, and JWTs before they leave your machine.

gstack-artifacts-init

Running gstack in Conductor? Conductor explicitly strips ANTHROPIC_API_KEY and OPENAI_API_KEY from every workspace's process env, so paid evals and gbrain embeddings won't work out of the box. Set GSTACK_ANTHROPIC_API_KEY and GSTACK_OPENAI_API_KEY in Conductor's workspace env config instead — gstack's TS entry points promote them to canonical names at runtime. Full details and the contributor checklist for adding the import to new entry points: Conductor + GSTACK_* env vars.

Full monty — every scenario, every flag, every bin helper, every troubleshooting step: USING_GBRAIN_WITH_GSTACK.md

Other references: docs/gbrain-sync.md (sync-specific guide) • docs/gbrain-sync-errors.md (error index)

Docs

Privacy & Telemetry

gstack includes opt-in usage telemetry to help improve the project. Here's exactly what happens:

• Default is off. Nothing is sent anywhere unless you explicitly say yes.
• On first run, gstack asks if you want to share anonymous usage data. You can say no.
• What's sent (if you opt in): skill name, duration, success/fail, gstack version, OS. That's it.
• What's never sent: code, file paths, repo names, branch names, prompts, or any user-generated content.
• Change anytime: gstack-config set telemetry off disables everything instantly.
• Every off-machine send is receipted. Any gstack-initiated network send — telemetry included — writes a hash-chained, tamper-evident receipt to ~/.gstack/security/egress.jsonl before the send; sensitive sinks refuse to send at all if the receipt can't be written. Audit with gstack-egress list, verify the chain with gstack-egress verify (exit 3 on tamper), see the standing consent settings with gstack-egress grants. The ledger records attempted sends so accidents are auditable — it's an audit trail, not a network firewall.
• Optional third-party bridges are off by default and receipted too. The one that exists today, the Memorable recall bridge, hands your prompt to a locally installed vendor binary only after you run gstack-memorable enable; every hand-off writes a receipt first, the consent shows up in gstack-egress grants, and what the vendor then sends is documented as the vendor's claim.

Data is stored in Supabase (open source Firebase alternative). The schema is in supabase/migrations/ — you can verify exactly what's collected. The Supabase publishable key in the repo is a public key (like a Firebase API key) — row-level security policies deny all direct access. Telemetry flows through validated edge functions that enforce schema checks, event type allowlists, and field length limits.

Local analytics are always available. Run gstack-analytics to see your personal usage dashboard from the local JSONL file — no remote data needed.

Troubleshooting

Skill not showing up? Run ./setup --status from your gstack checkout. It prints every install (host, scope, version, skills directory, source checkout) and, for a stale, missing or unregistered row, the exact command that fixes it. The usual fix is to re-run setup from that row's source for that host, e.g. cd ~/.claude/skills/gstack && ./setup (Claude) or cd ~/gstack && ./setup --host codex. A project install lives in the project's .claude/skills/gstack or .agents/skills/gstack; run its setup from inside the project.

/browse (or /qa, /design-review) says NEEDS_ASIDE or ASIDE_NOT_RUNNING? That's the probe telling you it's about to use the fallback browser. Want Aside? Open the app and sign in — aside --version should print a version and aside repl 'console.log("ok")' should print ok — then re-run. gstack never installs it for you. Want the fallback on purpose while Aside is open? GSTACK_SKIP_ASIDE=1 makes every skill, the renderer, and ./setup treat Aside as absent.

/browse fails on the fallback browser? cd ~/.claude/skills/gstack && bun install && bun run build

/make-pdf or /diagram can't render? Same two paths: with Aside open they print through Aside (bun run ~/.claude/skills/gstack/bin/gstack-render.ts some.html --screenshot /tmp/out.png tests it directly, and its first line, ENGINE=aside or ENGINE=browse, names the browser that actually rendered); without it they use the bundled browser, so bun run build is the fix.

Stale install? Run /gstack-upgrade — or set auto_upgrade: true in ~/.gstack/config.yaml

State in the wrong place, or a setting that won't stick? ~/.claude/skills/gstack/bin/gstack-paths --explain shows which directory gstack uses for its state and why. See docs/state-root.md.

Want shorter commands? cd ~/.claude/skills/gstack && ./setup --no-prefix — switches from /gstack-qa to /qa. Your choice is remembered for future upgrades.

Don't use some skills? gstack-config set disabled_skills make-pdf,pair-agent stops registering them on every host, so their descriptions stop loading into each session. Claude Code updates right away; other hosts on their next ./setup --host <name> or /gstack-upgrade. Their files stay installed, so a skill that calls a disabled one still works (you get a warning). Typos are rejected with the closest skill name, gstack-upgrade can't be disabled, and gstack-config set disabled_skills "" re-enables everything.

Want namespaced commands? cd ~/.claude/skills/gstack && ./setup --prefix — switches from /qa to /gstack-qa. Useful if you run other skill packs alongside gstack.

Codex says "Skipped loading skill(s) due to invalid SKILL.md"? Your Codex skill descriptions are stale. ${CODEX_HOME:-~/.codex}/skills/gstack is a runtime directory, not the checkout: ./setup --status shows the Codex row's source checkout. Fix: cd <that source> && git pull && ./setup --host codex — for a repo-local install, run it from inside the project.

Windows users: gstack works on Windows 11 via Git Bash or WSL. Aside is macOS-only, so on Windows (and Linux) the browser skills, /make-pdf, and /diagram always use gstack's bundled browser. Node.js is required in addition to Bun — Bun has a known bug with Playwright's pipe transport on Windows (bun#4253). The browse server automatically falls back to Node.js. Make sure both bun and node are on your PATH. Native /cso additionally requires Windows PowerShell and Visual Studio 2022 Build Tools with the Desktop development with C++ workload; setup leaves that skill explicitly unavailable when they are absent.

On Windows without Developer Mode (MSYS2 / Git Bash), setup falls back to file copies instead of symlinks because ln -snf produces frozen copies that don't refresh on git pull. Re-run cd ~/.claude/skills/gstack && ./setup after every git pull so your skill files match the repo. setup prints a one-line note reminding you. Unix and WSL keep symlinks and don't need the re-run.

Chromium install failed or hung during ./setup? The bundled browser is best-effort: setup records the reason, finishes registering every skill, and prints which skills are affected (/qa, /qa-only, /design-review, /browse, make-pdf, /diagram, /pair-agent). With Aside open, the browser skills keep running in Aside and only the fallback engine is missing; /pair-agent always needs the bundled browser. Fix the cause and re-run ./setup. Knobs: GSTACK_PLAYWRIGHT_INSTALL_TIMEOUT=<seconds> raises the download bound (default 600) on slow links; GSTACK_SKIP_PLAYWRIGHT=1 skips the Chromium install entirely (CI, no-browser boxes); GSTACK_CHROMIUM_NO_SANDBOX=1 is the fix when Chromium installs but cannot launch because the host blocks unprivileged user namespaces (Ubuntu 24.04+ AppArmor default, #2157).

Setup ended with "Not registered (a skill you own already uses the name; left untouched)"? gstack only deletes or links over a skill entry it can prove it created: a symlink into gstack, a directory carrying the .gstack-owned marker ./setup writes into every directory it creates, or a SKILL.md that is byte-identical to gstack's or carries the generated <!-- AUTO-GENERATED from ... --> banner. A qa/ or ship/ you wrote yourself is left untouched by ./setup, gstack-relink, and both prefix-mode flips, and the linker names it in the final summary. Rename or move yours, or switch modes (./setup --prefix / --no-prefix) so the names stop colliding. If you started your own skill from a generated gstack SKILL.md and then edited it, that file is moved to ~/.gstack/backups/skills/<timestamp>/<skill>/SKILL.md before gstack's is linked in, never deleted.

Claude says it can't see the skills? Make sure your project's CLAUDE.md has a gstack section. Add this:

## gstack
Use /browse from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.
Available skills: /office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review,
/design-consultation, /design-shotgun, /design-html, /review, /deslop-shared-libs, /test-audit, /ship, /land-and-deploy,
/canary, /benchmark, /browse, /open-gstack-browser, /qa, /qa-only, /design-review, /scrape,
/setup-browser-cookies, /setup-deploy, /setup-gbrain, /sync-gbrain, /retro, /investigate,
/document-release, /document-generate, /codex, /cso, /autoplan, /pair-agent, /careful, /freeze,
/guard, /unfreeze, /gstack-upgrade, /learn.

License

MIT. Free forever. Go build something.