gstack-geminicli is a collection of high-performance agentic "skills" designed to make AI-assisted development faster, safer, and more thorough.

This is a port of the original gstack (created by Garry Tan) specifically optimized for Google Gemini CLI.

The original gstack project was built exclusively for Claude Code. This port enables those same high-performance agentic skills to run natively within Google Gemini CLI, leveraging Gemini's unique architecture and massive context window.

By bringing gstack to the Gemini platform, you can:

• Leverage Massive Context: Ingest entire modules and large test suites to maintain absolute project coherence during complex refactors.
• Run Autonomous Workflows: Execute deep code reviews, automated QA, and root-cause investigations directly via Gemini CLI.
• Cross-Platform Engineering: Use a unified set of professional engineering skills across your entire development lifecycle.

• Google Gemini CLI installed and authenticated.
• GitHub CLI (gh) (recommended for PR and issue workflows).
• Shell Environment: A Bash-compatible shell is required (native on macOS/Linux, or Git Bash/WSL on Windows).

Clone this repository and link the skills to your Gemini CLI skills directory:

# Clone the repo
git clone https://github.com/YOUR_USERNAME/gstack-geminicli.git
cd gstack-geminicli

mkdir -p ~/.gemini/skills ln -s $(pwd)/review ~/.gemini/skills/review

## Platform Support
- **macOS**: Fully supported (tested on zsh/bash).
- **Linux**: Fully supported.
- **Windows**: Supported via **Git Bash**, **PowerShell** (with coreutils), or **WSL**.

## Key Skills Included

| Skill | Command | Description |
|-------|---------|-------------|
| **Review** | `/review` | Deep PR analysis for safety, race conditions, and structural issues. |
| **QA** | `/qa` | Autonomous end-to-end testing and bug discovery. |
| **Ship** | `/ship` | Pre-flight checks and PR creation. |
| **Investigate** | `/investigate` | Root-cause analysis of complex bugs. |
| **Plan** | `/plan-eng` | Architectural design and engineering reviews. |
| **Browse** | `/browse` | Headless browser interaction for UI/UX testing. |

## Credits

Original concept and implementation by **Garry Tan**. 
Original repository: [https://github.com/garrytan/gstack](https://github.com/garrytan)

Ported to Gemini CLI by [Your Name/GitHub Account].

## License

MIT License (See [LICENSE](LICENSE) for details).