garrytan/gstack

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/garrytan/gstack.svg?style=card)](https://bestofgithub.dev/repo/garrytan/gstack)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/garrytan/gstack.svg)](https://bestofgithub.dev/repo/garrytan/gstack)

Loading README…

Agent	Tier	Install	First invocation	Safety skills	Outside review needs	Repair
Claude Code	full	`--host claude` (default)	`/office-hours`	enforced (hooks block)	Codex CLI, signed in	`./setup --host claude`
OpenAI Codex CLI	experimental	`--host codex` → `${CODEX_HOME:-~/.codex}/skills/gstack-*/`	ask for `gstack-office-hours`	advisory, not blocked	Claude Code CLI, signed in	`./setup --host codex`
OpenCode	experimental	`--host opencode` → `~/.config/opencode/skills/gstack-/` + `/gstack-` commands	`/gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host opencode`
Cursor	experimental	`--host cursor` → `~/.cursor/skills/gstack-*/`	ask for `gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host cursor`
Factory Droid	experimental	`--host factory` → `~/.factory/skills/gstack-*/`	ask for `gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host factory`
Kiro	experimental	`--host kiro` → `~/.kiro/skills/gstack-*/`	ask for `gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host kiro`
GitHub Copilot CLI	experimental	`--host copilot` → `~/.copilot/skills/gstack-*/`	`/gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host copilot`
Antigravity CLI	experimental	`--host agy` (or `--host antigravity`) → `~/.gemini/antigravity-cli/skills/gstack-*/`	`/gstack-office-hours`	advisory, not blocked	Codex CLI, signed in	`./setup --host agy`
Slate	instruction-only	`--host slate` (points at the Claude install; Slate reads `.claude/skills`)	`/office-hours` via the Claude install	advisory, not blocked	—	`./setup --host claude`
OpenClaw	experimental	`--host openclaw` (five task skills and one `gstack` router skill in OpenClaw's skills folder; automatic when setup runs inside OpenClaw; ACP route in docs/OPENCLAW.md)	ask for the task; the agent opens the matching task skill or the `gstack` router	advisory, not blocked	—	`./setup --host openclaw`
Hermes	experimental	`--host hermes` (every skill in `$HERMES_HOME/skills/gstack`; automatic when setup runs inside Hermes)	ask for the task, or `/gstack-review`	advisory, not blocked	—	`./setup --host hermes`
GBrain (mod)	instruction-only	`--host gbrain` (brain-aware variants ship from the GBrain repo)	—	advisory, not blocked	—	—

Skill	Your specialist	What they do
`/office-hours`	YC Office Hours	Start here. Six forcing questions that reframe your product before you write code. Pushes back on your framing, challenges premises, generates implementation alternatives. Design doc feeds into every downstream skill.
`/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 in 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, explains what a 10 looks like, then edits the plan to get there. AI Slop detection. Interactive — one AskUserQuestion per design choice.
`/plan-devex-review`	Developer Experience Lead	Interactive DX review: explores developer personas, benchmarks against competitors' TTHW, designs your magical moment, traces friction points step by step. Scores error messages for the agents that read them (agent-ready errors). Three modes: DX EXPANSION, DX POLISH, DX TRIAGE. 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` in the open DESIGN.md format, so impeccable, Google Stitch, and any tool that reads it share one file.
`/review`	Staff Engineer	Find the bugs that pass CI but blow up in production. Auto-fixes the obvious ones. Flags completeness gaps and gate integrity: every weakened test, timeout, snapshot or suppression reaches a human by name. Advisory simplification lens flags over-built code — never blocks, never auto-applies.
`/deslop-shared-libs`	Shared Code Reviewer	Find worthwhile shared-code extractions in recent work. Compares up to five opportunities and recommends the best three, with source evidence, reliability gains, and total code savings. Recommendations only.
`/write-skill`	Skill Editor	Write a new agent skill or improve one without bloat. A five-step edit ladder (fix the tool first, add nothing the model already does, edit the line instead of appending, lowest level that reaches the agent, rule not story), `gstack-skill-bill` for size per level and growth since the last diet, a drift check that every gstack command and flag a skill names still exists, and full diets proven by a before/after/no-skill test.
`/test-audit`	Test Auditor	Sweep existing tests for ones that cost more than they protect: source greps, duplicates, assertion-free probes, test-only exports. Every candidate carries an evidence card; report-only unless you approve a batch.
`/investigate`	Debugger	Systematic root-cause debugging. Iron Law: no fixes without investigation. Traces data flow, tests hypotheses, stops after 3 failed fixes.
`/design-review`	Designer Who Codes	Same audit as /plan-design-review, then fixes what it finds. Atomic commits, before/after screenshots. If you have impeccable installed, its engine runs first and every mechanical finding arrives tagged with its rule id.
`/devex-review`	DX Tester	Live developer experience audit. Actually tests your onboarding: navigates docs, tries the getting started flow, times TTHW, triggers CLI errors the way an agent meets them (`gstack-error-capture`: no terminal, contained, redacted). Compares against `/plan-devex-review` scores — the boomerang that shows if your plan matched reality.
`/design-shotgun`	Design Explorer	"Show me options." Generates 4-6 AI mockup variants, opens a comparison board in your browser, collects your feedback, and iterates. Taste memory learns what you like. Repeat until you love something, then hand it to `/design-html`.
`/design-html`	Design Engineer	Turn a mockup into production HTML that actually works. Pretext computed layout: text reflows, heights adjust, layouts are dynamic. 30KB, zero deps. Detects React/Svelte/Vue. Smart API routing per design type (landing page vs dashboard vs form). One slop-gate pass through the impeccable engine when you have it. The output is shippable, not a demo.
`/design-motion`	Motion Designer	Turn an approved mockup, a finalized page or a URL into a showcase loop. Rebuilds the exact frame, loads it from empty, gives each visual one story, records deterministic frames on a fake clock, and exports an MP4 for X, a website GIF and an 800×500 GIF once the seam, empty-beat, rest and overflow checks pass. Needs ffmpeg.
`/qa`	QA Lead	Explore browser, API, CLI, job and webhook behavior. Reproduce bugs, write failing regressions, fix the cause and re-verify before committing.
`/qa-only`	QA Reporter	Explore and report with replayable evidence. Suggest regression cases without changing product code or tests.
`/pair-agent`	Multi-Agent Coordinator	Share gstack's own browser with any AI agent. One command, one paste, connected. Works with OpenClaw, Hermes, Codex, Cursor, or anything that can curl. Each agent gets its own tab. Auto-launches headed mode so you watch everything. Auto-starts ngrok tunnel for remote agents. Scoped tokens, tab isolation, rate limiting, activity attribution. (Runs on the bundled browser — the fallback engine; agents driving Aside just open their own tabs.)
`/cso`	Chief Security Officer	Security audit with an application model, supported findings, independent challenge, and explicit coverage. Static assessment remains available without catalog profiles. With matching qualified profiles, comprehensive mode adds contained runtime/scanner execution and reviewable repair candidates for Node/Bun, Python, and Rails. Qualified runtime and scanner images are published for linux/amd64 and linux/arm64. Without Docker, audits run static assessment only. Runtime-tested bundles authenticate separate external assertions. Project-test completion remains `self_reported` because target code controls the test process; `tested` is reserved for a future target-independent completion witness.
`/ship`	Release Engineer	Sync main, run tests, explore changed behavior, audit coverage, gate integrity and docs, then verify, push and open a PR.
`/land-and-deploy`	Release Engineer	Merge the PR, wait for CI and deploy, verify production health. One command from "approved" to "verified in production."
`/modernize`	Stale-PR Maintainer	Bring an aging PR onto its current base and say whether it should still exist: MODERNIZE (rebase, `git range-diff` proof, push with a lease pinned to the observed head), REWORK (the problem stands, the diff does not) or CLOSE (recommended, never done without permission). Reads the base's moved range for conflicts in meaning, not only in text.
`/canary`	SRE	Post-deploy monitoring loop. Watches for console errors, performance regressions, and page failures.
`/benchmark`	Performance Engineer	Baseline page load times, Core Web Vitals, and resource sizes. Compare before/after on every PR.
`/ubicloud`	Remote Runner	Run a heavy suite, build or eval on an ephemeral 16-vCPU Ubicloud VM: owner- and TTL-named VMs with a reaper, quota preflight, a hang watchdog, and one committed verify per repository.
`/eval-plan`	Eval Planner	Preregister a paid eval before the first priced call: bars, arms, decoys and stop rules, a $0 stub-model dry run over the real inputs, and a three-item priced pilot whose extrapolation and spend table gate the approval.
`/document-release`	Technical Writer	Audit changed behavior against project docs on every ship, before final verification and publication. Also runs standalone. Shows updated, reviewed/current or blocked docs and any remaining gaps.
`/document-generate`	Documentation Author	Generate missing docs from scratch using the Diataxis framework. Researches the codebase first, then writes reference / how-to / tutorial / explanation docs that actually match the code. Invokable standalone or chained from `/document-release` when the coverage map finds gaps. Learn more: tutorial • how-to • why Diataxis.
`/retro`	Eng Manager	Team-aware weekly retro. Per-person breakdowns, shipping streaks, test health trends, growth opportunities. `/retro global` runs across all your projects and AI tools (Claude Code, Codex, Gemini).
`/browse`	QA Engineer	Give the agent eyes. Drives your Aside browser first — your real sessions, real clicks, real screenshots — through deterministic `aside repl` scripts. No Aside? It falls back to gstack's own Chromium: real clicks, ~100ms per command, and `/open-gstack-browser` shows it headed with sidebar, anti-bot stealth, and auto model routing. Every other browser skill stands on it.
`/scrape`	Data Extractor	Pull structured data off a web page — tables, lists, prices — in your Aside browser with the page's real logged-in state. On the fallback browser, `/skillify` turns the flow into a permanent browser-skill that runs in ~200ms next time.
`/setup-browser-cookies`	Session Manager	Copy selected cookies from Chrome, Chromium, Brave, Edge, Windows-only Opera and Opera GX, or macOS-only Comet and Arc into gstack's bundled browser. Choose your profile and domains; copying and sign-in verification are separate. Only needed on the fallback path — Aside already has your sessions.
`/autoplan`	Review Pipeline	One command, fully reviewed plan. Runs CEO → design → DX → eng review automatically (eng always last, so the shipping gate reviews the final amended plan) with encoded decision principles. Surfaces only taste decisions for your approval.
`/spec`	Spec Author	Turn vague intent into a precise, executable spec in five phases (why, scope, technical with mandatory code-reading, draft, file). Outside-review quality gate before filing (Claude Code on Codex; Codex on other harnesses; blocks below 7/10), fail-closed secret redaction, dedupe against existing issues, archive to `$GSTACK_STATE_ROOT/projects/$SLUG/specs/` for team-corpus recall. `--execute` spawns `claude -p` in a fresh worktree; `/ship` auto-closes the source issue on merge. Plan-mode aware.
`/learn`	Memory	Manage what gstack learned across sessions. Review, search, prune, and export project-specific patterns, pitfalls, and preferences. Learnings compound across sessions so gstack gets smarter on your codebase over time.
`/make-pdf`	Publisher	Markdown in, publication-quality document out. Mermaid and excalidraw fences render as vector diagrams, fully offline. Images scale to the page and never truncate; wide diagrams get their own landscape page. `--to html` emits one self-contained file, `--to docx` a Word doc.
`/diagram`	Diagram Maker	English in, editable diagram out. Emits a triplet: mermaid source, `.excalidraw` you can open and edit on excalidraw.com (hand-drawn style), and rendered SVG/PNG. Zero network. Embed the source in markdown and `/make-pdf` renders it.

Building for...	Plan stage (before code)	Live audit (after shipping)
End users (UI, web app, mobile)	`/plan-design-review`	`/design-review`
Developers (API, CLI, SDK, docs)	`/plan-devex-review`	`/devex-review`
Architecture (data flow, perf, tests)	`/plan-eng-review`	`/review`
All of the above	`/autoplan` (runs CEO → design → DX → eng, auto-detects which apply; eng always last)	—

Skill	What it does
`/codex`	Second Opinion — independent code review from OpenAI Codex CLI. Review, challenge, and consult modes. Available on every harness except Codex.
`/claude-code`	Second Opinion — independent code review from Claude Code. Review, challenge, and consult modes, with session continuity for consultation. Available on every harness except Claude Code.
`/careful`	Safety Guardrails — warns before destructive commands (rm -rf, DROP TABLE, force-push). Say "be careful" to activate. Override any MEDIUM warning; root/home recursive deletes and default-branch force-pushes are hard-denied.
`/freeze`	Edit Lock — restrict file edits to one directory. Prevents accidental changes outside scope while debugging.
`/guard`	Full Safety — `/careful` + `/freeze` in one command. Maximum safety for prod work.
`/unfreeze`	Unlock — remove the `/freeze` boundary.
`/open-gstack-browser`	GStack Browser — launch gstack's own browser headed, with sidebar, anti-bot stealth, auto model routing (Sonnet for actions, Opus for analysis), one-click cookie import, and Claude Code integration. Clean up pages, take smart screenshots, edit CSS, and pass info back to your terminal. The visible face of the fallback engine; with Aside open you watch the agent's tabs there instead.
`/setup-deploy`	Deploy Configurator — one-time setup for `/land-and-deploy`. Detects your platform, production URL, and deploy commands.
`/setup-gbrain`	GBrain Onboarding — from zero to running gbrain in under 5 minutes. PGLite local, Supabase existing URL, or auto-provision a new Supabase project via Management API. MCP registration for Claude Code + per-repo trust triad (read-write/read-only/deny). Full guide.
`/sync-gbrain`	Keep Brain Current — re-index this repo's code into gbrain via `gbrain sources add` + `gbrain sync --strategy code`, refresh the `## GBrain Search Guidance` block in CLAUDE.md, and auto-remove guidance when the capability check fails. `--incremental` (default), `--full`, `--dry-run`. Idempotent; safe to re-run.
`/gstack-upgrade`	Self-Updater — upgrade gstack to latest. Detects global vs vendored install, syncs both, shows what changed.
`/captain`	Crew Controller — run many coding agents from one controller: lanes send a READY block and never merge, the controller merges through trains (stamp on call, verify, merge with the expected head), keeps the digest, relays approvals in a fixed shape and runs a daily flaky-fix pass. Also answers to `/crew`. Team guide.
`/ios-qa`	iOS Live-Device QA (v1.43.0.0+) — drive a real iPhone or iPad over USB CoreDevice via an embedded `StateServer` in the app. Read Swift source, codegen typed `@Observable` accessors, run the agent loop. Optional `--tailnet` flag exposes the device to OpenClaw or any HTTP-capable agent on your Tailscale tailnet so remote agents can run iOS QA without ever touching the hardware. Capability-tier allowlist (observe/interact/mutate/restore), per-device session lock, audit log.
`/ios-fix`, `/ios-design-review`, `/ios-clean`, `/ios-sync`	iOS bug-fix loop, designer's-eye HIG audit, debug-bridge cleanup, and accessor resync. See `docs/skills.md`. End-to-end walkthrough: docs/howto-ios-testing-with-gstack.md.

Doc	What it covers
Skill Deep Dives	Philosophy, examples, and workflow for every skill (includes Greptile integration)
The recommended harness	gstack + Capy from zero to the first merged train: install, the Captain and its Drive, trains, the daily flaky pass, the twice-weekly release, the factory scorecard, what is Capy-specific, known Capy limits
gstack + Capy: the software factory	What we built with Capy Captains and gstack, how the pieces fit, the measured before/after, tips, and how Garry uses it
Why gstack	The story, the productivity numbers and their caveats, Karpathy's failure modes, parallel sprints
Install details	Setup timing, requirements in detail, team mode, the hooks setup registers, agent harness registration
Other agents	Agent harnesses (OpenClaw, Hermes, dots, QM, Muse Code, Grok, any other), OpenClaw and ClawHub, per-host notes, the Codex profile and model tiers, outside-review providers, the design binary's models
QA without a webpage	`/qa` and `/qa-only` on CLIs, APIs, jobs, workers and webhooks
Standalone binaries	The standalone `gstack-*` CLIs (egress auditor, context bill, model benchmark, the review and evidence ledgers, the iOS QA daemon), and the CSO evaluation producer contract
Privacy & Telemetry	What is sent, what never is, the update check, outside reviews, egress receipts
Uninstall	The uninstall script and manual removal
Diagrams & Document Formats	Mermaid/excalidraw fences in PDFs, image sizing and safety defaults, `--to html\|docx`, `/diagram` triplets
First Production Deploy	What to do when `/setup-deploy` says nothing is deployed yet: hosting, env and secrets, DNS, checking it works, then back to `/setup-deploy`
Builder Ethos	Builder philosophy: Boil the Ocean, Search Before Building, three layers of knowledge
GBrain quick tour	The four setup paths, MCP registration, the per-repo trust policy, memory sync, Conductor env vars
Using GBrain with GStack	Every path, flag, bin helper, and troubleshooting step for `/setup-gbrain`
GBrain Sync	Cross-machine memory setup, privacy modes, troubleshooting
Architecture	Design decisions and system internals
Browser	How gstack drives Aside first (the contract, the cookbook, rendering, research), when the fallback engine kicks in, and the fallback's full `$B` command reference
Contributing	Dev setup, testing, contributor mode, and dev mode
Memorable recall bridge	Opt-in third-party workflow memory through gstack: two consents, what gstack hands over and can attest, removal, troubleshooting
Troubleshooting	Every `not run` / `unavailable` message, what it means, and the fix
Running a Captain crew	One controller, many lanes on Capy: the drive layout, CREW.md, the READY contract, merge trains, approvals, the digest and the daily flaky pass, with templates
Changelog	What's new in every version

garrytan/gstack

gstack

Quick start

Install — about 30 seconds

Step 1: Install on your machine

Step 2: Team mode — auto-update for shared repos (recommended)

Other AI Agents

See it work

The sprint

Which review should I use?

Power tools

GBrain — persistent knowledge for your coding agent

Platform notes

Docs

Privacy & Telemetry

Troubleshooting

License