gStack-Antigravity 🚀

한국어 README

gStack-Antigravity is a high-performance, team-ready port of garrytan/gstack built natively for the Antigravity agent environment.

It utilizes a Thin Router architecture and a Standard-Compliant Shared Engine to prioritize token efficiency, cross-platform reliability, and workspace isolation.

Developing AI workflows often hits two bottlenecks: Token Exhaustion and Execution Drift.

gStack-Antigravity solves these using:

• Thin Router Architecture: Instead of copying all logic to every project, we keep lightweight rules (.agents/rules/) locally. The heavy engine is shared globally for efficiency.
• Standard Compliance & Isolation: We follow Antigravity standards by storing the engine in ~/.gemini/antigravity/skills/, while ensuring project-level data (.gstack/) remains strictly isolated.

• Native Browser Integration: We use Antigravity's native browser_subagent tools as a first-class bridge, ensuring faster, more visual feedback.
• Cross-Platform Parity: Specialized support for macOS, Linux, and Windows.

gStack-Antigravity offers two paths for installation. Choose the one that fits your workflow. Both result in a fully optimized environment.

Initialize the project and build the browser engine in a single command.

# 1. Global Installation (One-time setup)
npm install -g @runchr/gstack-antigravity

# 2. Initialize in your project root
gstack-antigravity init

If the package is installed globally, you can let the AI handle the rest inside the Antigravity chat.

# 1. Global Installation (One-time setup)
npm install -g @runchr/gstack-antigravity

Then open Antigravity and enter the following command in the chat:

/gstack-setup

Antigravity workflows allow you to run complex, multi-step agent behaviors with a single command.

How do you actually use these commands? Let's walk through building a simple Memo App.

graph TD
    A[Idea: Memo App] --> B(Concept: /office-hours)
    B --> C(Audit: /plan-eng-review)
    C --> D{Implementation}
    D --> E(Bug Hunt: /qa)
    E --> F(PR Review: /review)
    F --> G(Final Release: /ship)

• User: "I want to build a memo app with voice recognition and tagging."
• Antigravity: Runs a brainstorming session to clarify the MVP features and user pain points.
• Outcome: A solid product spec and prioritized task list.

• User: "Here is my plan for the database schema and sync logic."
• Antigravity: Reviews the plan for race conditions, auth gaps, and edge cases.
• Outcome: A "hardened" implementation plan that is ready for coding.

• User: "Make sure the 'Delete Note' button works on both mobile and desktop."
• Antigravity: Spawns a headless browser, navigates to your local dev server, finds the button, and verifies the deletion in the database.
• Outcome: Discovers a UI bug on mobile and provides an automatic fix.

• User: "I'm ready to push this to production."
• Antigravity: Checks tests, updates the version, generates a changelog, creates a PR, and merges it once approved.
• Outcome: Your feature is live, documented, and versioned—without a single manual git command.

For manual control or technical integration, use the $B (browse) command set. These tools use a persistent headless Chromium instance.

• Orientation: $B goto [URL] -> $B snapshot -i (Highlights all interactive elements).
• Interaction: $B click @e1, $B fill @e2 "value".
• Assertion: $B is visible ".dashboard", $B console (Check JS errors).
• Evidence: $B screenshot, $B snapshot -a -o [path] (Annotated capture).

• goto <url>: Navigate to target.
• snapshot -i: Interactive accessibility tree with @e refs.
• snapshot -D: Unified diff against previous page state.
• responsive: Capture mobile, tablet, and desktop views at once.
• cookie-import-browser: Import real login sessions from your Chrome/Arc/Edge.
• handoff: Open visible Chrome for user takeover (CAPTCHA, etc.).

• Local Only: All session state, screenshots, and logs are kept in .gstack/ (ignored by git).
• /careful: Activates guardrails for destructive commands (rm -rf, DROP TABLE, force push).
• /guard: Maximum safety mode (read-only restrictions for specific modules).

If you are using gStack-Antigravity in a restricted corporate environment (Firewall/Proxy), you may encounter ECONNRESET errors during browser downloads.

If your network requires a proxy, set the HTTPS_PROXY environment variable before running setup:

HTTPS_PROXY=http://your-proxy-server:8080 /gstack-setup

To save tokens and avoid repeated download failures, you can run the setup without the browser installation:

/gstack-setup --skip-browser

This will build the core browse binary and register skills, but skip the Playwright Chromium download.

If the automated download fails, run this command manually in a standard terminal:

npx playwright install chromium

To sync with the original garrytan/gstack source:

./scripts/sync-gstack-origin.sh

MIT License. Created by garrytan, ported to Antigravity by runchr.