GitHub Projects Manager for VS Code

Gestiona tickets y proyectos de GitHub directamente desde VS Code. Esta extensión te permite crear, listar, actualizar y gestionar tickets (issues) de GitHub sin salir de tu editor favorito.

✨ Características

• 🎫 Crear tickets directamente desde VS Code
• 📋 Listar tickets con filtros por estado, etiquetas, asignados
• ✏️ Actualizar tickets existentes (título, descripción, estado, etiquetas)
• 🔍 Ver detalles completos de cualquier ticket
• 🌐 Abrir en GitHub con un clic
• 🔄 Actualización automática de la lista de tickets
• 📁 Panel lateral organizado por estado (Abiertos/Cerrados)

🚀 Inicio Rápido

1. Instalar la extensión

Busca "GitHub Projects Manager" en el marketplace de VS Code o instala desde aquí.

2. Configurar Token de GitHub

1. Ve a GitHub Settings > Personal Access Tokens
2. Crea un nuevo token con permisos:
   • repo (acceso completo a repositorios)
   • read:user (leer información del usuario)
   • read:org (leer información de organizaciones)
3. Copia el token

3. Configurar en VS Code

1. Abre VS Code Settings (Ctrl+,)
2. Busca "GitHub Projects"
3. Pega tu token en GitHub Projects: Token
4. Opcionalmente configura repositorio por defecto

📖 Uso

Comandos Disponibles

Abre la paleta de comandos (Ctrl+Shift+P) y busca:

• GitHub Projects: Crear Ticket - Crear un nuevo issue
• GitHub Projects: Listar Tickets - Ver todos los tickets del repositorio
• GitHub Projects: Actualizar Ticket - Modificar un ticket existente
• GitHub Projects: Ver Detalles del Ticket - Ver información completa
• GitHub Projects: Listar Proyectos - Ver proyectos (funcionalidad limitada)

Panel Lateral

La extensión añade un panel "GitHub Projects" en el Explorer que muestra:

• Tickets organizados por estado (Abiertos/Cerrados)
• Información resumida de cada ticket
• Acciones rápidas con clic derecho

⚙️ Configuración

🔧 Desarrollo

Prerequisitos

• Node.js >= 16
• npm >= 8
• VS Code >= 1.74.0

Clonar y configurar

git clone https://github.com/NachoNavarroCarter/github-projects-vscode.git
cd github-projects-vscode
npm install

Desarrollo local

# Compilar TypeScript
npm run compile

# Modo watch para desarrollo
npm run watch

# Ejecutar en modo desarrollo (F5 en VS Code)
# Esto abrirá una nueva ventana con la extensión cargada

Empaquetar

# Crear archivo .vsix
npm run package

# Instalar localmente
code --install-extension github-projects-vscode-1.0.0.vsix

🤝 Contribuir

1. Fork el repositorio
2. Crea una rama para tu feature (git checkout -b feature/amazing-feature)
3. Commit tus cambios (git commit -m 'Add amazing feature')
4. Push a la rama (git push origin feature/amazing-feature)
5. Abre un Pull Request

📝 Changelog

[1.0.0] - 2025-07-09

• ✨ Versión inicial
• 🎫 Crear, listar y actualizar tickets
• 📁 Panel lateral con vista organizada
• ⚙️ Configuración completa
• 🔄 Auto-refresh de tickets

📄 Licencia

Este proyecto está bajo la licencia MIT - ver el archivo LICENSE para más detalles.

🙋‍♂️ Soporte

¿Tienes preguntas o problemas?

• 🐛 Reportar un bug
• 💡 Solicitar una feature
• 📧 Contacto directo

🌟 ¿Te gusta la extensión?

Si esta extensión te resulta útil, considera:

• ⭐ Darle una estrella en GitHub
• 📝 Escribir una reseña en el marketplace
• 🐦 Compartirla en redes sociales

Desarrollado con ❤️ por Nacho Navarro Carter