🚀 IDE Extensions Manager Suite

Una suite completa de herramientas para gestionar, sincronizar y limpiar extensiones de editores de código (VSCode, Antigravity, Cursor, Trae AI, Windsurf, Kiro AI). Todo perfectamente organizado en un directorio centralizado.

📋 Tabla de Contenidos

• Instalación Rápida
• Estructura del Directorio
• Scripts Incluidos
• Uso Detallado
• Ejemplos Prácticos
• Configuración Avanzada
• Solución de Problemas
• Contribuir

🚀 Instalación Rápida

# 1. Navegar al directorio
cd ide_extensions_manager/

# 2. Ejecutar instalador automático
./install.sh

# 3. ¡Listo! Usar menú interactivo
./ide_manager.sh

📋 Estructura del Directorio

ide_extensions_manager/
├── 🔧 SCRIPTS PRINCIPALES
│   ├── ide_manager.sh                     # 🎯 Script maestro con menú interactivo
│   ├── cleanup_vscode_extensions.sh       # 🧹 Limpieza inteligente de VSCode
│   ├── sync_extensions_to_antigravity.sh  # 🔄 Sincronización VSCode → Antigravity
│   └── extension_manager.sh               # 🚀 Gestor avanzado multi-editor
│
├── ⚙️ CONFIGURACIÓN E INSTALACIÓN
│   ├── config.sh                          # 📊 Configuración centralizada
│   └── install.sh                         # 📦 Instalador automático
│
├── 📚 DOCUMENTACIÓN
│   ├── README.md                          # 📝 Documentación completa
│   ├── INFO.md                           # ⚡ Guía rápida
│   └── original_extensions_list.md        # 📋 Lista original de extensiones
│
└── 📋 LISTAS ADICIONALES
    ├── extensiones_cursor.md
    └── extensiones_vscode_insider.md

📚 Descripción General

Esta suite de herramientas está diseñada para resolver los problemas comunes al gestionar extensiones en múltiples editores de código:

• 🧹 Limpieza de extensiones duplicadas e innecesarias
• 🔄 Sincronización entre diferentes editores
• 💾 Backup y restauración de configuraciones
• 📊 Análisis y comparación de extensiones

¿Por qué usar estos scripts?

• Mejora el rendimiento eliminando extensiones redundantes
• Sincroniza fácilmente tu setup entre editores
• Mantiene backups automáticos de tus configuraciones
• Ahorra tiempo con instalación masiva inteligente

📦 Scripts Incluidos

0. 🎯 ide_manager.sh - SCRIPT MAESTRO

Punto de acceso unificado con menú interactivo

¡La nueva forma de usar toda la suite! Incluye:

• 📊 Menú interactivo fácil de usar
• 🚀 Comandos directos para usuarios avanzados
• 🔍 Verificación automática de editores disponibles
• 📊 Ejecución segura con manejo de errores
• 📝 Acceso rápido a documentación y listas

1. 🧹 cleanup_vscode_extensions.sh

Script de limpieza inteligente para VSCode

Elimina extensiones duplicadas, redundantes e innecesarias organizadas en 10 categorías:

• Temas redundantes (mantiene 3-4 principales)
• Asistentes IA duplicados (mantiene Copilot + Claude)
• Extensiones Python redundantes (mantiene oficiales de Microsoft)
• Herramientas Git duplicadas (mantiene GitLens)
• Y más...

2. 🔄 sync_extensions_to_antigravity.sh

Sincronización directa VSCode → Antigravity

Script especializado para migrar todas las extensiones de VSCode a Antigravity con:

• Filtrado inteligente de extensiones ya instaladas
• Progreso en tiempo real
• Logs detallados de éxito y errores
• Verificación final de sincronización

3. 🚀 extension_manager.sh

Gestor avanzado multi-editor

Herramienta completa para gestión entre VSCode, Antigravity, Cursor y los nuevos IDEs AI:

• Backup automático con timestamp
• Sincronización bidireccional
• Comparación detallada entre editores
• Instalación desde archivos de backup
• NUEVO: Soporte para Trae AI, Windsurf y Kiro AI

4. 📦 install.sh

Instalador automático de la suite

Configura todo automáticamente:

• Verificación de prerrequisitos
• Configuración de permisos
• Creación de alias de shell
• Setup de directorios
• Tests básicos de funcionamiento

5. ⚙️ config.sh

Configuración centralizada

Personalización completa:

• Configuración de extensiones a mantener
• Parámetros de sincronización
• Directorios personalizados
• Validación de configuración
• NUEVO: Configuración para IDEs AI (Trae, Windsurf, Kiro)

📋 NUEVAS FUNCIONALIDADES AVANZADAS (2024)

6. 📱 GUI - Interfaz Gráfica

Interfaz visual nativa para macOS

Acceso completo vía interfaz gráfica:

• launch_gui.sh - Lanzador de GUI
• ide_manager_gui.scpt - AppleScript principal
• Diálogos nativos de macOS con choose from list
• Notificaciones del sistema integradas
• Acceso visual a todas las 11 herramientas
• Ejecución: ./ide_manager.sh gui

7. 📋 profiles_manager.sh

Gestión de perfiles de extensiones

Perfiles predefinidos listos para usar:

• Frontend, Backend, Fullstack, Data Science
• DevOps, AI/ML, Mobile, Minimal
• Creación de perfiles personalizados
• Aplicación rápida a cualquier IDE

8. ⏰ auto_sync.sh

Sincronización automática programada

Automatización completa:

• Programación con cron/launchd (macOS)
• Configuración de frecuencia (horaria, diaria, semanal)
• Logs de sincronización automática
• Notificaciones de estado

9. 🔗 dotfiles_integration.sh

Integración con sistemas dotfiles

Soporte para:

• Chezmoi, dotfiles tradicionales, Brewfile
• Backup automático de configuraciones IDE
• Sincronización con repositorios dotfiles
• Generación de scripts de instalación

10. 🤖 ai_ides_config.sh

Configuraciones IDEs AI

Gestión especializada:

• Templates para Trae AI, Windsurf, Kiro AI
• Backup de configuraciones AI
• Sincronización entre proyectos
• Detección automática de IDEs AI

11. 🧠 ai_agents_integration.sh

Integración con agentes AI nativos

Conectividad avanzada:

• Hooks para agentes AI nativos
• Monitoreo de procesos AI en tiempo real
• Invocación de agentes con contexto
• API connectivity testing

12. 🛠️ Herramientas de Diagnóstico

Scripts especializados para diagnóstico y recuperación

Herramientas de resolución de problemas:

• monitor_sync.sh - Monitor en tiempo real de sincronizaciones
• resume_sync.sh - Reanudación con timeouts automáticos
• test_diagnostic.sh - Verificación de todas las funcionalidades
• Menú interactivo de diagnóstico integrado
• Comandos CLI rápidos para limpieza y recuperación

🆕 NUEVOS IDES SOPORTADOS

🤖 Trae AI

Editor AI nativo construido sobre VSCode

• Comando CLI: trae (configurar desde Cmd+Shift+P → "Shell Command")
• Instalación: Descargar desde trae.ai + configurar shell command
• Características: Basado en VSCode OSS, extensiones compatibles, IA integrada
• Compatibilidad: ✅ Extensiones VSCode completas + AI nativo

🌊 Windsurf

IDE AI-nativo de Codeium

• Comando CLI: windsurf (configurar desde IDE o usar windsurf-cli)
• Instalación: Descargar desde windsurf.com o usar windsurf-cli
• Características: Compatible con extensiones VSCode, AI integrado
• Compatibilidad: ✅ Soporte completo para extensiones y sincronización

🎆 Kiro AI

Plataforma AI spec-driven construida sobre VSCode OSS

• Comando CLI: kiro (configurar durante onboarding o desde settings)
• Instalación: curl -fsSL https://kiro.dev/install | sh + configurar CLI
• Características: VSCode OSS base, OpenVSX registry, desarrollo spec-driven
• Compatibilidad: ✅ Importación completa de VSCode (settings + extensiones)

📋 Tabla de Compatibilidad

IDE	Extensiones VSCode	Backup/Sync	CLI Disponible	Base
VSCode	✅	✅	✅	Microsoft VSCode
VSCode Insiders	✅	✅	✅	Microsoft VSCode
Antigravity	✅	✅	✅	Editor independiente
Cursor	✅	✅	✅	VSCode OSS + AI
Windsurf	✅	✅	✅	VSCode OSS + AI
Trae AI	✅	✅	✅	VSCode OSS + AI
Kiro AI	✅	✅	✅	VSCode OSS + AI

📝 Nota: Trae AI y Kiro AI requieren configuración del shell command desde sus respectivos IDEs

✨ ESTADO DEL PROYECTO - COMPLETADO

🚀 Suite Completamente Funcional - Versión 2.0

Resumen de implementación exitosa:

• ✅ 15 scripts desarrollados y funcionales
• ✅ 7 IDEs soportados (VSCode, VSCode Insiders, Antigravity, Cursor, Trae, Windsurf, Kiro)
• ✅ 6 mejoras avanzadas implementadas:
  • Perfiles de extensiones
  • Sincronización automática programada
  • Integración con dotfiles
  • Configuraciones IDEs AI
  • Integración agentes AI nativos
  • Interfaz gráfica (GUI)
• ✅ Herramientas de diagnóstico integradas para resolución de problemas

📁 Inventario Final (25 archivos)

Scripts principales (15):

• ide_manager.sh - Script maestro con 13 opciones de menú
• cleanup_vscode_extensions.sh - Limpieza VSCode
• sync_extensions_to_antigravity.sh - Sync VSCode → Antigravity
• extension_manager.sh - Gestor multi-editor
• profiles_manager.sh - Perfiles de extensiones
• auto_sync.sh - Sincronización automática
• dotfiles_integration.sh - Integración dotfiles
• ai_ides_config.sh - Configuraciones IDEs AI
• ai_agents_integration.sh - Agentes AI nativos
• launch_gui.sh - Lanzador GUI
• ide_manager_gui.scpt - Interfaz gráfica AppleScript
• monitor_sync.sh - Monitor de sincronización tiempo real
• resume_sync.sh - Reanudación con timeouts automáticos
• test_diagnostic.sh - Verificación de funcionalidades
• config.sh - Configuraciones

Documentación (4):

• README.md - Documentación principal
• GUI_README.md - Documentación GUI
• original_extensions_list.md - Lista original
• INFO.md - Guía rápida

Listas de extensiones (9):

• Archivos .md con extensiones detectadas para cada IDE

🎆 Características Únicas

1. Interfaz dual: CLI + GUI nativa macOS
2. Soporte completo: 7 IDEs incluyendo los más recientes (Trae, Windsurf, Kiro)
3. Automatización: Sincronización programada con LaunchAgent
4. Integración: Dotfiles (Chezmoi, tradicionales, Brewfile)
5. AI-First: Configuraciones especializadas para IDEs AI
6. Agentes nativos: Hooks e integración con agentes AI
7. Perfiles inteligentes: 8 perfiles predefinidos + personalizados

🚀 Acceso Rápido

# Menú principal CLI
./ide_manager.sh

# Interfaz gráfica
./ide_manager.sh gui

# Herramientas de diagnóstico
./ide_manager.sh diagnostic        # Menú interactivo completo
./ide_manager.sh monitor            # Monitor tiempo real
./ide_manager.sh resume src dst     # Reanudar sincronización
./ide_manager.sh clean-processes    # Limpiar procesos atascados

# Comandos directos disponibles
./ide_manager.sh cleanup
./ide_manager.sh sync  
./ide_manager.sh profiles list
./ide_manager.sh auto-sync status
./ide_manager.sh dotfiles detect
./ide_manager.sh ai-ides templates
./ide_manager.sh ai-agents monitor

🏁 El proyecto está completo y listo para producción ✨

🎯 Uso Detallado

Opción 1: Menú Interactivo (Recomendado)

# Ejecutar script maestro
./ide_manager.sh

Menú principal incluye:

• 🧹 Limpiar VSCode (con opciones)
• 🔄 Sincronizar VSCode → Antigravity (normal/verificar/forzar)
• 🚀 Gestor Multi-Editor (submenú completo)
• 📋 Ver listas de extensiones
• 📝 Ver documentación
• 🔍 Verificar estado de IDEs

Opción 2: Comandos Directos

# Limpieza rápida de VSCode
./ide_manager.sh cleanup

# Sincronización básica
./ide_manager.sh sync

# Solo verificar sincronización
./ide_manager.sh sync --verify

# Forzar reinstalación completa
./ide_manager.sh sync --force

# Comandos del gestor avanzado
./ide_manager.sh manager backup
./ide_manager.sh manager compare
./ide_manager.sh manager sync vscode cursor

Opción 3: Scripts Individuales

Si prefieres usar los scripts directamente:

# Limpieza de VSCode
./cleanup_vscode_extensions.sh

# Sincronización a Antigravity
./sync_extensions_to_antigravity.sh
./sync_extensions_to_antigravity.sh --verify
./sync_extensions_to_antigravity.sh --force

# Gestor multi-editor
./extension_manager.sh backup
./extension_manager.sh compare
./extension_manager.sh sync vscode antigravity

El script te preguntará por cada sección:

• ✅ TEMAS REDUNDANTES - Elimina temas duplicados
• ✅ ICONOS REDUNDANTES - Mantiene Material Icon Theme
• ✅ ASISTENTES IA - Mantiene Copilot + Claude
• ✅ PYTHON DUPLICADOS - Mantiene extensiones oficiales
• ✅ GIT DUPLICADOS - Mantiene GitLens
• ✅ FORMATEO DUPLICADO - Mantiene Prettier
• ✅ LENGUAJES NO USADOS - Java, Go, Rust, etc.
• ✅ CONTAINERIZACIÓN - Docker/Kubernetes
• ✅ ESPECIALIZADAS - Herramientas nicho
• ✅ SNIPPETS DUPLICADOS - Autocompletado redundante

Script 2: Sincronización VSCode → Antigravity

# Sincronización normal (solo extensiones faltantes)
./sync_extensions_to_antigravity.sh

# Solo verificar sin instalar
./sync_extensions_to_antigravity.sh --verify

# Reinstalar todas las extensiones
./sync_extensions_to_antigravity.sh --force

# Mostrar ayuda
./sync_extensions_to_antigravity.sh --help

Script 3: Gestor Multi-Editor

# Ver comandos disponibles
./extension_manager.sh

# Hacer backup de todas las extensiones
./extension_manager.sh backup

# Comparar extensiones entre editores
./extension_manager.sh compare

# Sincronizar entre cualquier par de editores
./extension_manager.sh sync vscode antigravity
./extension_manager.sh sync antigravity cursor
./extension_manager.sh sync cursor vscode
./extension_manager.sh sync vscode windsurf
./extension_manager.sh sync windsurf cursor

# Instalar desde backup
./extension_manager.sh install ~/.editor_extensions_backup/vscode_extensions_20231224_120000.txt antigravity

# Listar editores disponibles
./extension_manager.sh list

💡 Ejemplos Prácticos

Flujo 1: Setup Inicial Completo

# 1. Instalación y configuración
./install.sh

# 2. Backup inicial de seguridad
./ide_manager.sh manager backup

# 3. Ver estado actual
./ide_manager.sh manager compare

# 4. Usar menú interactivo para explorar
./ide_manager.sh

Flujo 2: Limpiar y Sincronizar (Clásico)

# 1. Hacer backup antes de limpiar
./ide_manager.sh manager backup

# 2. Limpiar VSCode eliminando redundancias
./ide_manager.sh cleanup

# 3. Sincronizar VSCode limpio → Antigravity
./ide_manager.sh sync

# 4. Verificar sincronización
./ide_manager.sh manager compare

Flujo 3: Migración Rápida a Nuevo Editor

# 1. Verificar editores disponibles
./ide_manager.sh manager list

# 2. Sincronizar directamente
./ide_manager.sh manager sync vscode cursor
./ide_manager.sh manager sync vscode windsurf  # Nuevo: Windsurf

# 3. Verificar resultado
./ide_manager.sh sync --verify

Flujo 4: Trabajo con IDEs AI Nativos

# Para Trae AI y Kiro AI (no usan extensiones tradicionales)
# 1. Verificar disponibilidad
./ide_manager.sh

# 2. Ver estado de todos los IDEs
./ide_manager.sh manager list

# 3. Usar funcionalidades nativas de cada IDE AI
# Trae: Usar comandos naturales en terminal
# Kiro: Desarrollo spec-driven

Migración de Editor

# Escenario: Migrar de VSCode a Cursor
# 1. Backup del estado actual
./extension_manager.sh backup

# 2. Ver diferencias
./extension_manager.sh compare

# 3. Sincronizar
./extension_manager.sh sync vscode cursor

# 4. Verificar resultado
./extension_manager.sh list

Restauración desde Backup

# Ver backups disponibles
ls ~/.editor_extensions_backup/

# Restaurar configuración específica
./extension_manager.sh install ~/.editor_extensions_backup/vscode_extensions_20231224_120000.txt antigravity

⚙️ Configuración Avanzada

Personalización con config.sh

El archivo config.sh permite personalizar todos los comportamientos:

# Ver configuración actual
source config.sh && show_current_config

# Crear configuración personal
source config.sh && create_user_config

Configuraciones Disponibles:

# Cambiar extensiones a mantener
KEEP_THEMES+=("mi-tema-favorito.theme")

# Personalizar delays
INSTALL_DELAY=0.5

# Cambiar directorio de backups
BACKUP_DIR="$HOME/mis_backups"

# Extensiones que nunca sincronizar
NEVER_SYNC+=("mi-extension-local")

Logs y Debugging

# Logs automáticos en /tmp/
tail -f /tmp/antigravity_install.log
tail -f /tmp/antigravity_errors.log

# Debug mode para scripts
bash -x ./ide_manager.sh cleanup

# Verificar configuración
source config.sh && validate_config

Archivos de Configuración

Estructura de Directorios:

~/.editor_extensions_backup/     # Backups automáticos
~/.ide_extensions_config         # Configuración personal
/tmp/                           # Logs temporales
ide_extensions_manager/         # Scripts principales

Configuración Personal:

El instalador puede crear ~/.ide_extensions_config para personalizaciones:

#!/bin/bash
# Ejemplo de personalizaciones

# Cambiar directorio de backups
BACKUP_DIR="$HOME/mis_backups_extensiones"

# Habilitar notificaciones
ENABLE_NOTIFICATIONS=true

# Agregar temas personales
KEEP_THEMES+=("mi-tema.extension")

📊 Información de Salida

Ejemplo de Limpieza

=== ELIMINANDO TEMAS REDUNDANTES ===
Mantenemos: dracula-theme, zhuangtongfa.material-theme, github.github-vscode-theme

  [-] Eliminando: ahmadawais.shades-of-purple
      Razón: Tema redundante - Similar funcionalidad a Dracula
      ✓ Eliminada exitosamente

✅ Instalaciones exitosas: 45
❌ Instalaciones fallidas: 2

Ejemplo de Sincronización

🔄 Sincronizando: Vscode → Antigravity

📊 Análisis:
  Vscode: 264 extensiones
  Antigravity: 12 extensiones
  Por instalar: 252 extensiones

[100%] (252/252) ms-python.python
✅ Exitosas: 250
❌ Fallidas: 2

Ejemplo de Comparación

📈 RESUMEN POR EDITOR:
  Vscode: 264 extensiones
  Antigravity: 254 extensiones
  Cursor: 180 extensiones

🔍 COMPARACIÓN DETALLADA:

  Vscode ↔ Antigravity:
    Comunes: 250
    Solo en vscode: 14
    Solo en antigravity: 4

🛠️ Solución de Problemas

Errores Comunes

CLI no encontrado

❌ VSCode CLI 'code' no encontrado.

Solución: Instalar CLI desde el editor (Cmd+Shift+P → "Shell Command: Install...")

Permisos de ejecución

bash: ./script.sh: Permission denied

Solución:

chmod +x *.sh

Extensión no se instala

❌ Error al instalar: extension.name

Solución: Verificar que la extensión existe en el marketplace del editor destino.

Debug Mode

Para debugging detallado, ejecutar con:

bash -x ./script.sh

Recuperación

Si algo sale mal:

# Restaurar desde backup más reciente
ls ~/.editor_extensions_backup/
./extension_manager.sh install <archivo-backup> <editor>

📈 Rendimiento y Optimización

Estadísticas Típicas

Antes de limpieza:

• VSCode: ~264 extensiones
• Tiempo de inicio: ~8-12 segundos
• Uso de memoria: ~400-600 MB

Después de limpieza:

• VSCode: ~120-150 extensiones
• Tiempo de inicio: ~3-5 segundos
• Uso de memoria: ~200-350 MB

Recomendaciones

1. Ejecutar limpieza mensualmente
2. Hacer backup antes de cambios importantes
3. Usar modo --verify para comprobar estado
4. Revisar logs de errores periódicamente

🤝 Contribuir

Reportar Problemas

1. Crear issue con:
   • Sistema operativo
   • Editores instalados
   • Comando ejecutado
   • Error completo
   • Logs relevantes

Mejoras Sugeridas

• Soporte para más editores (Trae AI, Windsurf, Kiro AI)
• Interfaz gráfica
• Perfiles de extensiones
• Sincronización automática programada
• Integración con dotfiles
• Soporte para configuraciones de IDEs AI
• Integración con agentes AI nativos

Desarrollo

# Clonar repositorio
git clone <repo>

# Crear rama para feature
git checkout -b feature/nueva-funcionalidad

# Hacer cambios y commit
git commit -m "feat: agregar nueva funcionalidad"

# Push y crear PR
git push origin feature/nueva-funcionalidad

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para detalles.

🙏 Agradecimientos

• Comunidad de VSCode por las extensiones
• Desarrolladores de Antigravity y Cursor
• Equipos de Trae AI, Windsurf (Codeium) y Kiro AI
• Comunidad de desarrollo con IA
• Contribuidores y testers

---

🚀 Comenzar Ahora

Instalación en 3 Pasos:

1. Navegar al directorio:

   cd ide_extensions_manager/

2. Ejecutar instalador:

   ./install.sh

3. ¡Usar menú interactivo!

   ./ide_manager.sh

Acceso Rápido Después de Instalación:

# Si configuraste alias durante instalación:
ide-manager

# O ruta completa:
./ide_extensions_manager/ide_manager.sh

📞 Soporte y Referencias

Archivos de Referencia:

• README.md - Esta documentación completa
• INFO.md - Guía rápida de referencia
• config.sh - Todas las opciones de configuración
• original_extensions_list.md - Lista base de extensiones

Directorio de Backups:

# Ver backups creados
ls ~/.editor_extensions_backup/

# Restaurar desde backup
./ide_manager.sh manager install <archivo-backup> <editor>

Tips de Uso:

• Siempre hacer backup antes de cambios importantes
• Usar modo --verify para revisar sin instalar
• Personalizar config.sh para tu workflow
• Revisar logs en /tmp/ si hay errores

🆕 Instalación Rápida de Nuevos IDEs:

# Trae AI
# 1. Descargar desde: https://trae.ai
# 2. Abrir Trae → Cmd+Shift+P → "Shell Command: Install 'trae' command"

# Windsurf
# 1. Descargar desde: https://windsurf.com
# 2. CLI se configura automáticamente o usar: npm install -g windsurf-cli

# Kiro AI  
# 1. Instalar: curl -fsSL https://kiro.dev/install | sh
# 2. Durante onboarding, configurar shell integration

# Verificar instalaciones
./ide_manager.sh  # Verá todos los IDEs detectados con conteo de extensiones

🔍 Verificación de Estado:

# Estado completo de todos los IDEs
./ide_manager.sh manager list

# Verificación individual con conteo de extensiones
command -v trae && echo "Trae AI: ✅" && trae --list-extensions | wc -l
command -v windsurf && echo "Windsurf: ✅" && windsurf --list-extensions | wc -l
command -v kiro && echo "Kiro AI: ✅" && kiro --list-extensions | wc -l

# Menú completo con detección automática
./ide_manager.sh  # Verá contadores de extensiones para todos los IDEs

¡Optimiza tu setup de desarrollo y ahorra horas de configuración manual! 🎯