gstack for Amazon Q
AI-powered development workflows for Amazon Q Developer — zero config, auto-routing, real browser automation.
What is gstack?
gstack turns Amazon Q into a full development co-pilot. Instead of writing prompts from scratch, you describe what you want in plain English and gstack automatically runs the right workflow.
@gstack there's a bug in the login page
@gstack review my code
@gstack ship this
@gstack QA http://localhost:3000
@gstack security audit
Quick Start
- Install this extension
- Open any project in VS Code
- In Amazon Q chat, type
@gstack followed by what you want
That's it. No configuration required.
Workflows
| What you say |
Workflow |
What it does |
there's a bug in X |
INVESTIGATE |
Root cause analysis, stack trace reading, fix suggestions |
review my code |
REVIEW |
Code quality, security, confidence score 0–100 |
ship this |
SHIP |
Version bump, changelog, git tag, release notes |
QA http://localhost:3000 |
QA |
Browser automation, screenshot evidence, test report |
security audit |
CSO |
OWASP Top 10 + STRIDE threat modeling |
weekly retro |
RETRO |
Velocity metrics, blockers, action items |
I want to build X |
OFFICE-HOURS |
Architecture planning, tech stack advice |
plan this feature |
AUTOPLAN |
Break down features into tasks with estimates |
Browser Automation
gstack includes a real Chromium browser you can control from Amazon Q chat:
@gstack QA http://localhost:3000
@gstack take a screenshot of the homepage
@gstack click the login button and fill in the form
The browser starts once (~3s) and stays running. Subsequent commands respond in ~100ms. Cookies and tabs persist across commands.
Chrome setup — the extension auto-detects Chrome. If not found, place Chrome at:
%USERPROFILE%\Downloads\chrome-win\chrome-win\chrome.exe
Or set the CHROME_PATH environment variable.
Commands
Access via Command Palette (Ctrl+Shift+P):
| Command |
Description |
gstack: Setup for this project |
Re-run setup / re-link project |
gstack: Open Browser |
Open a URL in the gstack browser |
gstack: Stop Browser |
Stop the browser server |
gstack: Update |
Update runtime files to latest |
How it works
On first install, gstack:
- Copies runtime files to
~/.gstack/
- Installs the
@gstack prompt to ~/.aws/amazonq/prompts/
- Links every project you open by creating
.amazonq/rules/gstack.md
The rules file tells Amazon Q which workflows are available and how to invoke the browser — automatically, for every project.
Requirements
- Amazon Q Developer extension installed
- Node.js 18+
- Windows (full support), macOS/Linux (workflows only, browser requires Chrome)
License
MIT
