gstack 설치 및 사용 가이드
gstack 설치 방법, 주요 명령어, 실제 사용 예시를 통해 AI 협업 프레임워크를 활용하는 방법을 학습합니다.
gstack 설치 및 사용 가이드
필수 요구사항
gstack을 설치하기 전에 다음 도구들이 필요합니다:
| 도구 | 버전 | 설명 |
|---|---|---|
| AI 에이전트 | - | Claude Code, Codex CLI 등 |
| Git | - | 버전 관리 시스템 |
| Bun | v1.0+ | JavaScript 런타임 (필수) |
| Node.js | - | Windows에서만 필요 |
Bun 설치하기
bun이 설치되어 있지 않다면 먼저 설치하세요:
Bash
# macOS / Linux
curl -fsSL https://bun.sh/install | bash
# Windows (PowerShell)
powershell -c "irm bun.sh/install.ps1|iex"
# 또는 npm으로 설치
npm install -g bun
설치 확인:
Bash
bun --version
설치 방법
모델별 설치 명령어
각 AI 에이전트마다 설치 경로와 설정 파일이 다릅니다. 자신이 사용하는 에이전트에 맞게 설치하세요:
| 에이전트 | 설치 명령어 | 설치 경로 | 설정 파일 |
|---|---|---|---|
| Claude Code | ./setup | ~/.claude/skills/gstack | CLAUDE.md |
| OpenAI Codex CLI | ./setup --host codex | ~/.codex/skills/gstack | .codex.md |
| Cursor | ./setup --host cursor | ~/.cursor/skills/gstack | .cursor.md |
| OpenCode | ./setup --host opencode | ~/.config/opencode/skills/gstack | OPENCODE.md |
| Factory Droid | ./setup --host factory | ~/.factory/skills/gstack | FACTORY.md |
| Slate | ./setup --host slate | ~/.slate/skills/gstack | .slate.md |
| Kiro | ./setup --host kiro | ~/.kiro/skills/gstack | .kiro.md |
기본 설치 (30초) - Claude Code 예시
Claude Code 터미널에서 다음 명령어를 실행하세요:
Bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup
이 명령어는:
- gstack 저장소를 로컬에 클론
~/.claude/skills/gstack디렉토리에 설치- 자동으로 setup 스크립트 실행하여 설치 완료
설치 후 CLAUDE.md 파일이 자동으로 업데이트되어 모든 스킬을 사용할 수 있게 됩니다.
Codex CLI 설치 예시
Bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.codex/skills/gstack && cd ~/.codex/skills/gstack && ./setup --host codex
설치 후 .codex.md 파일이 자동으로 업데이트됩니다.
Cursor 설치 예시
Bash
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.cursor/skills/gstack && cd ~/.cursor/skills/gstack && ./setup --host cursor
설치 후 .cursor.md 파일이 자동으로 업데이트됩니다.
팀 모드 설정 (권장)
여러 개발자가 공유하는 프로젝트에서는 --team 플래그를 추가하세요:
Bash
# Claude Code 팀 모드
cd ~/.claude/skills/gstack && ./setup --team
# Codex CLI 팀 모드
cd ~/.codex/skills/gstack && ./setup --host codex --team
# 모두 커밋
git add .claude/ .codex.md CLAUDE.md && git commit -m "require gstack for AI-assisted work"
이렇게 하면 모든 팀 멤버가 자동으로 최신 버전을 받게 됩니다.
자동 감지 기능
설정 파일이 자신이 설치한 에이전트를 자동으로 감지하므로, 여러 에이전트를 동시에 사용하는 경우 각각 설치할 수 있습니다. gstack은 호환되는 모든 에이전트에서 자동으로 작동합니다.
주요 명령어
| 명령어 | 설명 |
|---|---|
/office-hours | 제품 개념 재검토 및 설계 문서 작성 |
/plan-ceo-review | 범위와 전략 검토 |
/plan-eng-review | 아키텍처 및 테스트 계획 수립 |
/review | 코드 검토 및 버그 찾기 |
/qa | 실제 브라우저에서 앱 테스트 |
/ship | PR 생성 및 배포 |
사용 예시
예: 일일 브리핑 앱 만들기
Markdown
1. /office-hours
→ 제품 개념 재검토
(예: "달력용 일일 브리핑"이 실제로는 "개인 비서 AI"를 원함)
2. /plan-ceo-review
→ 프로젝트 범위와 전략 검토
→ 4가지 범위 모드 중 선택
3. 코드 구현 (일반 작업)
4. /review
→ 코드 자동 검토 및 버그 찾기
5. /qa
→ 실제 브라우저에서 테스트 및 버그 수정
6. /ship
→ PR 생성 및 배포