gstack-opencode-adapter

Work in progress. This is an OpenCode adaptation of gstack by Garry Tan. Paths, tool names, and some skill behaviors have been adapted for OpenCode's skill system. Not everything is fully working yet. Some skills may behave unexpectedly. Bug reports and contributions welcome.

Forked from garrytan/gstack.

---

An adapter that brings gstack (Garry Tan's AI engineering workflow) to the OpenCode platform.

gstack turns AI agents into a virtual engineering team with structured roles for software development. Each skill is a specialist: CEO reviewer, eng manager, designer, QA lead, release engineer, and more.

What This Is

This is a fork and adaptation of the original gstack repository, modified to work with OpenCode's skill system and tool invocation patterns. It preserves all of gstack's functionality while adapting paths, tool names, and configuration for the OpenCode environment.

Quick Start

Prerequisites

• OpenCode (>= 0.9.x)
• Git (>= 2.x)
• Bun (>= 1.0) — for building the browse binary
• Node.js (>= 18.x) — runtime for browse binary
• macOS (primary), Linux (secondary), Windows (WSL only)

Installation

# Clone to OpenCode skills directory
git clone https://github.com/TMFNK/gstack-OpenCode.git ~/.config/opencode/skills/gstack

# Run setup
cd ~/.config/opencode/skills/gstack
./setup

Development Setup

For local development and testing:

# Clone the repo
git clone https://github.com/TMFNK/gstack-OpenCode.git
cd gstack-OpenCode

# Set up dev environment
./bin/dev-setup-opencode

# Tear down when done
./bin/dev-teardown-opencode

Available Skills

Skill	What It Does
/office-hours	YC Office Hours — reframes your product idea before you write code
/plan-ceo-review	CEO-level review — find the 10-star product in the request
/plan-eng-review	Eng manager review — lock architecture, data flow, edge cases, and tests
/plan-design-review	Design review — rate each dimension 0-10, explain what a 10 looks like
/design-consultation	Build a complete design system from scratch
/review	Pre-landing PR review — finds bugs that pass CI but break in prod
/investigate	Systematic root-cause debugging
/design-review	Design audit + fix loop with atomic commits
/qa	Test your app, find bugs, fix them, re-verify
/qa-only	Same as /qa but report only — no code changes
/ship	Run tests, review, push, open PR
/document-release	Update all docs to match what you just shipped
/retro	Weekly retro with per-person breakdowns
/browse	Headless browser — real Chromium, real clicks, ~100ms/command
/setup-browser-cookies	Import cookies from your real browser for authenticated testing
/careful	Warn before destructive commands
/freeze	Lock edits to one directory
/guard	Full safety mode — /careful + /freeze
/unfreeze	Remove directory edit restrictions
/gstack-upgrade	Update gstack to latest version
/codex	Second opinion from OpenAI Codex CLI

Key Differences from Original gstack

Original gstack	OpenCode Adapter
~/.claude/skills/gstack/	~/.config/opencode/skills/gstack/
Claude Code Skill tool	OpenCode skill tool
AskUserQuestion	question tool
$B browse command	gstack browse command
Claude-specific preamble	OpenCode-compatible preamble

Upstream Sync

This adapter is designed to track upstream gstack changes:

# Add upstream remote (one time)
git remote add upstream https://github.com/garrytan/gstack.git

# Pull latest changes
./scripts/sync-upstream.sh

See MODIFIED_FILES.md for the list of files modified for OpenCode compatibility.

Troubleshooting

Skill not showing up?

cd ~/.config/opencode/skills/gstack && ./setup

Browse binary fails?

cd ~/.config/opencode/skills/gstack
bun install && bun run build

Stale install? Run /gstack-upgrade — or reinstall from scratch.

Privacy & Telemetry

Telemetry is disabled by default in the OpenCode adapter. If you want to help improve gstack, you can opt in:

~/.config/opencode/skills/gstack/bin/gstack-config set telemetry community

License

MIT. Free forever. Based on gstack by Garry Tan.