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.