Cap 2: Instalación y Configuración

Requisitos

• Claude Code instalado y configurado
• Git v2.x+
• Bun v1.0+ (curl -fsSL https://bun.sh/install | bash)
• Node.js (solo requerido en Windows)

Instalación global (recomendada)

Instala gstack en ~/.claude/skills/gstack — disponible en todos tus proyectos:

git clone --single-branch --depth 1 \
  https://github.com/garrytan/gstack.git \
  ~/.claude/skills/gstack \
  && cd ~/.claude/skills/gstack \
  && ./setup

Instalación por proyecto

Copia gstack dentro del proyecto, útil para equipos o control de versión de los skills:

# Primero instalar globalmente, luego:
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack && ./setup

Verificación

Después de instalar, en Claude Code deberías ver los skills disponibles. Si no aparecen:

cd ~/.claude/skills/gstack && ./setup

Configuración de prefijos

Por defecto los skills se llaman /qa, /review, etc. Si usas otros skill packs en paralelo, puedes prefijar con /gstack-:

# Con prefijo (evita colisiones)
./setup --prefix

# Sin prefijo (default, comandos más cortos)
./setup --no-prefix

Plataformas alternativas

gstack no es exclusivo de Claude Code:

Plataforma	Comando de setup
Claude Code	./setup (default)
OpenAI Codex	./setup --host codex
Auto-detect	./setup --host auto
Factory Droid	./setup --host factory

Actualización

# Actualizar manualmente
cd ~/.claude/skills/gstack && git pull && ./setup

# O desde Claude Code
/gstack-upgrade

También puedes habilitar auto-actualización:

gstack-config set auto_upgrade true

Telemetría (opt-in)

Al instalar, gstack pregunta si deseas compartir telemetría anónima. Es completamente opcional:

Qué recopila (si opt-in):

• Nombre del skill usado
• Duración
• Éxito o error
• Versión de gstack y OS

Qué NUNCA recopila:

• Código fuente
• Rutas de archivos
• Nombre del repo o branch
• Prompts ni mensajes

Para desactivar en cualquier momento:

gstack-config set telemetry off

Ver analytics locales:

gstack-analytics

Troubleshooting

Problema	Solución
Skill no aparece en Claude	cd ~/.claude/skills/gstack && ./setup
/browse falla	cd ~/.claude/skills/gstack && bun install && bun run build
Instalación stale	Ejecutar /gstack-upgrade o git pull && ./setup
Problema en Windows	Usar Git Bash o WSL; asegurar Node.js instalado junto a Bun
Skills faltantes en Claude	Agregar sección gstack al CLAUDE.md del proyecto