Trae-GStack

AI-driven development workflow toolkit for Trae IDE, based on GStack philosophy: "Don't be half-invested, boil the whole lake".

Features

• 21 Commands - Complete workflow from ideation to deployment
• One-Click Install - Automatic installation for Trae
• Natural Language - Works with both commands and natural language
• Smart Router - Single entry point for all workflows
• State Management - Share context between workflow steps

Prerequisites

• Node.js: >= 18.0.0
• Trae IDE: Installed and configured
• Package Manager: pnpm (recommended), npm, or yarn

Quick Install

Option 1: npx 一键安装（推荐）

npx @xdmjun/trae-gstack

这将自动：

1. 下载并安装包
2. 配置 Trae MCP
3. 安装技能文件到 .trae/skills/
4. 重启 Trae IDE 即可使用

Option 2: 全局安装

npm install -g @xdmjun/trae-gstack
trae-gstack

Option 3: 本地开发安装

git clone https://github.com/xdmjun/trae-gstack.git
cd trae-gstack
pnpm install
pnpm build
node scripts/install-trae.js

Usage

In Trae AI

Start by asking for help:

使用 gstack

Or use any of these commands:

验证想法：做一个 AI 代码审查工具
帮我审查代码
运行测试
部署项目

Available Commands

| Category | 自然语言触发 | 功能描述 | |----------|-------------|---------| | 构思阶段 | "验证这个想法" / "YC评审" | YC风格产品验证 | | | "CEO评审" / "CEO review" | CEO视角评审 | | | "工程架构评审" / "技术方案 review" | 工程架构评审 | | | "设计评审" / "UI评审" | 设计评审 | | 开发阶段 | "审查代码" / "review my code" | 代码审查（带自动修复） | | | "调查问题" / "排查bug" | 根因分析 | | | "设计咨询" / "design consultation" | 设计系统咨询 | | 测试阶段 | "运行测试" / "跑QA" | 测试（带自动修复） | | | "生成测试报告" | 仅生成测试报告 | | | "部署" / "ship it" | 自动化发布 | | 文档阶段 | "更新文档" / "document release" | 更新项目文档 | | | "团队回顾" / "写周报" | 团队回顾和周报 | | 工具 | "第二意见" / "codex review" | OpenAI Codex独立审查 | | | "危险操作警告" / "careful" | 危险操作检查 | | | "锁定文件" / "freeze" | 锁定文件编辑范围 | | | "安全模式" / "guard" | 完全安全模式 |

Example Workflow

# 开始新项目
验证想法：做一个在线文档协作工具

# 规划阶段
CEO 评审这个功能
工程架构评审一下

# 开发阶段
[编写代码...]

# 审查与部署
帮我审查代码
运行测试
部署项目

Project Structure

trae-gstack/
├── src/
│   ├── server.ts          # Main MCP server
│   ├── types.ts           # Type definitions
│   ├── state-manager.ts   # Workflow state management
│   └── commands/
│       └── index.ts      # Command handlers (21 commands)
├── skills/
│   └── trae-gstack/
│       └── SKILL.md      # Trae skill configuration
├── scripts/
│   └── install-trae.js    # Auto-install script
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

Development

Commands

# Install dependencies
pnpm install

# Development mode
pnpm dev

# Build
pnpm build

# Test with Inspector
pnpm inspect

# Type check
pnpm typecheck

Install/Uninstall

# Install (auto-detects Trae config path)
node scripts/install-trae.js

# Uninstall
node scripts/install-trae.js --uninstall

Troubleshooting

MCP Connection Failed

1. Check if Node.js >= 18 is installed:

   node --version

2. Verify the build exists:

   pnpm build

3. Check Trae MCP settings:

   • Settings → MCP
   • Verify "trae-gstack" shows "Connected"
   • If not, remove and re-add

Commands Not Working

1. Restart Trae IDE
2. Make sure you're using the "Builder with MCP" agent
3. Try: Settings → MCP → click "trae-gstack" → Test Connection

Path Issues

The install script uses absolute paths automatically. If you manually configure:

// ❌ Wrong - relative path
"args": ["./dist/server.js"]

// ✅ Correct - absolute path
"args": ["/home/user/projects/trae-gstack/dist/server.js"]

Philosophy

"Don't be half-invested, boil the whole lake" - Garry Tan

GStack encourages:

• Complete implementation, not shortcuts
• Fix problems, don't just note them
• 100% quality is achievable

Contributing

Contributions welcome! See CONTRIBUTING.md.

License

MIT License - see LICENSE.