gstack-opencode
Garry Tan's gstack ported to OpenCode. Complete AI engineering workflow with 27 skills.
What's Included
Sprint Skills (20)
| Skill |
What it does |
/office-hours |
YC Office Hours — reframes your product idea |
/plan-ceo-review |
CEO review — find the 10-star product |
/plan-eng-review |
Eng manager — lock architecture, data flow, tests |
/plan-design-review |
Designer review — rate each dimension 0-10 |
/design-consultation |
Build a design system from scratch |
/review |
Staff engineer — find bugs that pass CI |
/ship |
Release engineer — tests, push, PR |
/land-and-deploy |
Merge PR, CI, deploy, verify |
/qa |
QA lead — browser testing, fix bugs |
/qa-only |
QA reporter — bug report only |
/design-review |
Designer audit + auto-fix |
/canary |
SRE — post-deploy monitoring |
/benchmark |
Performance engineer — Core Web Vitals |
/document-release |
Technical writer — update docs |
/retro |
Eng manager — weekly retro |
/investigate |
Debugger — systematic root-cause |
/cso |
Security officer — OWASP + STRIDE |
/codex |
Second opinion — OpenAI Codex review |
/autoplan |
Auto-review pipeline |
/setup-deploy |
Deploy configurator |
Safety Skills (4)
| Skill |
What it does |
/careful |
Warn before destructive commands |
/freeze |
Lock edits to one directory |
/guard |
Full safety: careful + freeze |
/unfreeze |
Remove freeze restriction |
Browse Skills (8)
| Skill |
What it does |
/browse |
Headless Chromium — ~100ms/command |
/setup-browser-cookies |
Import cookies from real browser |
/qa |
Browser-based QA testing |
/design-review |
Visual audit with screenshots |
/canary |
Monitor deployed app |
/benchmark |
Performance baselines |
/land-and-deploy |
Post-deploy verification |
/setup-browser-cookies |
Session management |
Installation
Prerequisites
Quick Install
# Clone this repo
git clone https://github.com/your-username/gstack-opencode.git ~/gstack-opencode
# Run setup
cd ~/gstack-opencode && ./setup
# Add to your shell profile
echo 'source ~/gstack-opencode/bin/gstack-env.sh' >> ~/.zshrc
source ~/.zshrc
Manual Install
# 1. Clone gstack
git clone https://github.com/garrytan/gstack.git ~/gstack-opencode/source
# 2. Build browse
cd ~/gstack-opencode/source
bun install
bun build --compile browse/src/cli.ts --outfile ~/gstack-opencode/browse/dist/browse
# 3. Link skills to OpenCode
mkdir -p ~/.config/opencode/skills/gstack
ln -sf ~/gstack-opencode/skills/* ~/.config/opencode/skills/gstack/
Directory Structure
~/gstack-opencode/
├── skills/ # 27 OpenCode skills
│ ├── office-hours/SKILL.md
│ ├── review/SKILL.md
│ ├── browse/SKILL.md
│ └── ...
├── browse/ # Headless browser engine
│ └── dist/browse # Compiled binary (63MB)
├── bin/ # Tool scripts
│ ├── gstack-env.sh # Environment setup
│ ├── gstack-slug # Generate repo slug
│ └── ...
├── plugin/ # OpenCode plugin
│ └── gstack-guardian.js # Safety mechanism
├── review/ # Shared assets
│ ├── checklist.md
│ └── ...
├── ETHOS.md # Builder philosophy
├── BROWSER.md # Browser command reference
├── setup # Installation script
└── README.md # This file
Environment Variables
| Variable |
Description |
GSTACK_OPENCODE_DIR |
Path to gstack-opencode directory |
GSTACK_BROWSE |
Path to browse binary |
Safety Mechanism
The /careful, /freeze, and /guard skills are implemented as an OpenCode plugin (plugin/gstack-guardian.js). It intercepts:
- Destructive commands:
rm -rf, DROP TABLE, git push --force, etc.
- Freeze violations: Edits outside the locked directory
Differences from Original gstack
| Aspect |
Claude Code |
OpenCode |
| Hook mechanism |
PreToolUse hooks |
Plugin tool.execute.before |
| Environment vars |
${CLAUDE_SKILL_DIR} |
${GSTACK_OPENCODE_DIR} |
| Safety skills |
Shell scripts |
JavaScript plugin |
| Skill format |
YAML + Markdown |
YAML + Markdown (simplified) |
Credits
Original gstack by Garry Tan — MIT License
OpenCode port by gstack-opencode contributors
License
MIT
0daffeb8c2