claude-desktop-enhanced

# Claude Desktop Enhanced for Arch Linux <div align="center">  [](https://github.com/ayres/claude-desktop-enhanced/releases) [](https://aur.archlinux.org/packages/claude-desktop-enhanced) [](https://github.com/ayres/claude-desktop-enhanced/stargazers) [](LICENSE) [](https://aur.archlinux.org/packages/claude-desktop-enhanced) **🚀 La experiencia definitiva de Claude Desktop para Arch Linux** *Potenciado con gestión inteligente de MCP, detección automática de Wayland, y manejo robusto de configuraciones* [📦 Instalación](#-instalación) • [✨ Características](#-características) • [🚀 Uso Rápido](#-uso-rápido) • [📚 Documentación](#-documentación) • [🤝 Contribuir](#-contribuir) </div> --- ## 📋 Tabla de Contenidos - [🎯 Visión del Proyecto](#-visión-del-proyecto) - [✨ Características Principales](#-características-principales) - [📦 Instalación](#-instalación) - [Instalación Rápida (Recomendada)](#instalación-rápida-recomendada) - [Instalación Manual](#instalación-manual) - [Configuración Post-Instalación](#configuración-post-instalación) - [🚀 Uso Rápido](#-uso-rápido) - [⚙️ Configuración](#️-configuración) - [Gestión de Servidores MCP](#gestión-de-servidores-mcp) - [Configuración de Entorno](#configuración-de-entorno) - [Servidores MCP Disponibles](#servidores-mcp-disponibles) - [🛠️ Arquitectura del Sistema](#️-arquitectura-del-sistema) - [🔧 Solución de Problemas](#-solución-de-problemas) - [🗺️ Roadmap](#️-roadmap) - [🤝 Contribuir](#-contribuir) - [❓ Preguntas Frecuentes](#-preguntas-frecuentes) - [🏆 Reconocimientos](#-reconocimientos) - [📄 Licencia](#-licencia) --- ## 🎯 **Visión del Proyecto** Claude Desktop Enhanced transforma la experiencia de usar el asistente de IA de Anthropic en Arch Linux, elevándola desde una simple aplicación hasta una suite completa de herramientas inteligentes que se adaptan automáticamente a tu entorno y necesidades específicas. ### ¿Por qué Claude Desktop Enhanced? **Problema que resolvemos:** La versión oficial de Claude Desktop está diseñada para Windows y macOS, dejando a los usuarios de Linux con instalaciones complicadas, configuraciones manuales tediosas, y una experiencia subóptima que no aprovecha las características únicas de nuestro sistema operativo. **Nuestra solución:** Una distribución nativa, inteligente y completamente integrada que no solo funciona perfectamente en Arch Linux, sino que además ofrece capacidades avanzadas que van más allá de la aplicación original. ### Filosofía de Diseño - **🧠 Inteligencia Automática:** El sistema detecta y optimiza automáticamente para tu entorno específico - **🔧 Gestión Simplificada:** Comandos de una línea para operaciones complejas - **🛡️ Seguridad por Diseño:** Backups automáticos y recuperación robusta - **🌐 Integración Nativa:** Sigue estándares de Arch Linux y XDG - **📈 Extensibilidad:** Arquitectura modular para crecimiento futuro --- ## ✨ **Características Principales** ### 🔧 **Gestión Inteligente de MCP (Model Context Protocol)** <details> <summary><strong>🎯 Instalación con Un Solo Comando</strong></summary> ```bash # Instala y configura automáticamente servidores MCP claude-mcp install filesystem # Acceso al sistema de archivos claude-mcp install brave-search # Búsqueda web integrada claude-mcp install github # Integración con GitHub ``` **¿Qué hace especial nuestro sistema MCP?** - **Validación automática:** Verifica que cada servidor funcione correctamente después de la instalación - **Configuración inteligente:** Detecta rutas y configuraciones óptimas para tu sistema - **Resolución de dependencias:** Instala automáticamente las herramientas necesarias (Node.js, Python, etc.) - **Gestión de versiones:** Mantiene compatibilidad entre diferentes versiones de servidores </details> <details> <summary><strong>💾 Sistema de Backup Inteligente</strong></summary> **Protección automática contra errores:** - Backup automático antes de cada cambio importante - Múltiples generaciones de respaldo (no solo el último) - Recuperación instantánea con `claude-mcp restore` - Migración desde instalaciones existentes de Claude **Estadísticas y monitoreo:** ```bash claude-mcp stats # Ver historial de backups y uso del sistema claude-mcp health # Diagnóstico completo del sistema ``` </details> ### 🖥️ **Detección Inteligente de Entorno** <details> <summary><strong>🔍 Optimización Automática por Compositor</strong></summary> **Wayland (Optimización automática para cada compositor):** - **Sway:** Configuración específica para mejor rendimiento en tiling - **Hyprland:** Soporte para animaciones suaves y efectos avanzados - **GNOME:** Integración con PipeWire para captura de pantalla - **KDE Plasma:** Optimización para decoraciones de ventana **X11 (Configuración tradicional optimizada):** - **Aceleración GPU:** Habilitación automática de VAAPI - **Window Managers:** Detección y optimización para i3, bspwm, awesome - **Entornos de Escritorio:** Configuración específica para GNOME, KDE, XFCE </details> <details> <summary><strong>📊 Manejo Inteligente de HiDPI</strong></summary> - **Detección automática:** Factor de escala basado en tu configuración actual - **Configuración persistente:** Recuerda tus preferencias entre sesiones - **Soporte multi-monitor:** Diferentes escalas para diferentes pantallas </details> ### 🎨 **Integración Nativa con Arch Linux** <details> <summary><strong>📦 Experiencia AUR Completa</strong></summary> ```bash # Instalación estándar de Arch yay -S claude-desktop-enhanced # O tu helper de AUR favorito paru -S claude-desktop-enhanced # Funciona con cualquier helper # Actualizaciones automáticas yay -Syu # Actualiza junto con el resto del sistema ``` **Integración del sistema:** - **.desktop file** con acciones personalizadas - **Iconos HiDPI** en todos los tamaños estándar - **Seguimiento de estándares XDG** para ubicación de archivos - **Integración con systemd** para gestión de servicios </details> ### 🛡️ **Características de Producción** <details> <summary><strong>🚨 Sistema de Diagnóstico Avanzado</strong></summary> ```bash # Diagnóstico completo del sistema claude-mcp diagnose # Información detallada del entorno /usr/share/claude-desktop-enhanced/wayland-detector.sh info # Logs estructurados para debugging journalctl --user -f | grep claude ``` **Capacidades de diagnóstico:** - **Verificación de dependencias:** Confirma que todas las herramientas necesarias están instaladas - **Test de conectividad:** Prueba la comunicación con servidores MCP - **Análisis de rendimiento:** Identifica cuellos de botella potenciales - **Reportes de compatibilidad:** Información detallada sobre tu entorno específico </details> --- ## 📦 **Instalación** ### **Instalación Rápida (Recomendada)** La forma más sencilla de instalar Claude Desktop Enhanced es utilizando tu helper de AUR favorito. Estos comandos descargarán, compilarán e instalarán automáticamente todas las dependencias necesarias. ```bash # Usando yay (más popular) yay -S claude-desktop-enhanced # Usando paru (alternativa moderna) paru -S claude-desktop-enhanced # Usando aura (para usuarios avanzados) sudo aura -A claude-desktop-enhanced ``` **¿Qué sucede durante la instalación?** 1. **Descarga de fuentes:** Obtiene el instalador oficial de Claude y herramientas de compatibilidad 2. **Compilación de bindings:** Construye los bindings nativos de Linux usando patchy-cnb 3. **Parcheo de aplicación:** Aplica modificaciones específicas para compatibilidad con Linux 4. **Integración del sistema:** Instala iconos, archivos .desktop, y scripts de gestión 5. **Configuración inicial:** Establece configuraciones por defecto optimizadas ### **Instalación Manual** Para desarrolladores o usuarios que prefieren control completo sobre el proceso: ```bash # Clona el repositorio desde AUR git clone https://aur.archlinux.org/claude-desktop-enhanced.git cd claude-desktop-enhanced # Revisa el PKGBUILD (siempre buena práctica) less PKGBUILD # Construye e instala makepkg -si ``` **Dependencias que se instalan automáticamente:** - **Tiempo de ejecución:** `electron` (motor de la aplicación) - **Construcción:** `p7zip`, `npm`, `nodejs`, `rust`, `cargo`, `imagemagick`, `icoutils` - **Opcionales:** `docker`, `python`, `jq` (para funcionalidades avanzadas) ### **Configuración Post-Instalación** Una vez instalado el paquete, hay algunos pasos recomendados para obtener la mejor experiencia: ```bash # 1. Instala tu primer servidor MCP (acceso básico a archivos) claude-mcp install filesystem # 2. Verifica que todo funciona correctamente claude-mcp list # 3. Lanza Claude Desktop Enhanced claude-desktop-enhanced # 4. (Opcional) Configura servidores MCP adicionales claude-mcp install brave-search # Búsqueda web (requiere API key) ``` **Primera ejecución:** - El sistema detectará automáticamente tu entorno (Wayland/X11) - Se creará la estructura de directorios de configuración - Se importarán configuraciones existentes de Claude si las tienes - Se establecerán las optimizaciones apropiadas para tu compositor --- ## 🚀 **Uso Rápido** ### **Comandos Esenciales** ```bash # Aplicación principal claude-desktop-enhanced # Lanza la aplicación claude-desktop-enhanced --help # Ver opciones de línea de comandos # Gestión de servidores MCP claude-mcp list # Ver servidores disponibles e instalados claude-mcp install <servidor> # Instalar nuevo servidor MCP claude-mcp remove <servidor> # Remover servidor MCP claude-mcp backup # Crear backup manual de configuración claude-mcp restore # Restaurar desde último backup # Diagnóstico y información del sistema claude-mcp diagnose # Diagnóstico completo del sistema claude-mcp health # Estado de salud de servidores MCP /usr/share/claude-desktop-enhanced/wayland-detector.sh info # Info del entorno ``` ### **Flujo de Trabajo Típico** **Para nuevos usuarios:** 1. **Instalación:** `yay -S claude-desktop-enhanced` 2. **Configuración básica:** `claude-mcp install filesystem` 3. **Primera ejecución:** `claude-desktop-enhanced` 4. **Exploración:** Usar Claude para tareas básicas como análisis de archivos 5. **Expansión:** Instalar servidores MCP adicionales según necesidades **Para usuarios existentes de Claude:** 1. **Instalación:** El sistema detectará automáticamente configuraciones existentes 2. **Migración:** Las configuraciones se importarán automáticamente 3. **Mejoras:** Beneficiarse inmediatamente de las optimizaciones de entorno 4. **Gestión:** Usar `claude-mcp` para administrar servidores de forma más eficiente ### **Integración con Desktop Environment** **Desde el menú de aplicaciones:** - Busca "Claude Desktop Enhanced" en tu lanzador de aplicaciones - También aparece en la categoría "Office" y "Development" **Línea de comandos avanzada:** ```bash # Ejecutar con debugging habilitado ELECTRON_ENABLE_LOGGING=1 claude-desktop-enhanced # Forzar modo X11 (si tienes problemas en Wayland) export WAYLAND_DISPLAY="" claude-desktop-enhanced # Ejecutar con configuración específica claude-desktop-enhanced --user-data-dir=/path/to/custom/config ``` --- ## ⚙️ **Configuración** ### **Gestión de Servidores MCP** El corazón de Claude Desktop Enhanced es su sistema de gestión de MCP (Model Context Protocol). Este sistema permite que Claude acceda a herramientas externas y recursos de tu sistema de manera segura y controlada. **Archivo de configuración principal:** ```bash ~/.config/Claude-Enhanced/claude_desktop_config.json ``` **Estructura básica de configuración:** ```json { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home"], "description": "Acceso seguro al sistema de archivos" }, "brave-search": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-brave-search"], "env": { "BRAVE_API_KEY": "tu-api-key-aqui" }, "description": "Búsqueda web integrada" } } } ``` ### **Configuración de Entorno** El launcher inteligente detecta automáticamente tu entorno y aplica las optimizaciones apropiadas. Sin embargo, puedes personalizar este comportamiento: **Variables de entorno personalizadas:** ```bash # En tu ~/.bashrc o ~/.zshrc # Forzar uso de Wayland específicamente export CLAUDE_FORCE_WAYLAND=1 # Usar factor de escala personalizado export CLAUDE_SCALE_FACTOR=1.5 # Habilitar logs de debugging por defecto export CLAUDE_DEBUG=1 # Usar directorio de configuración personalizado export CLAUDE_CONFIG_DIR="$HOME/.config/claude-custom" ``` **Configuración por compositor:** El sistema detecta automáticamente tu compositor y aplica configuraciones específicas, pero puedes override estas configuraciones: ```bash # Para Sway echo 'export CLAUDE_WAYLAND_FLAGS="--enable-features=UseOzonePlatform --ozone-platform=wayland"' >> ~/.config/sway/config # Para Hyprland echo 'env = CLAUDE_WAYLAND_FLAGS,--enable-features=UseOzonePlatform --ozone-platform=wayland' >> ~/.config/hypr/hyprland.conf ``` ### **Servidores MCP Disponibles** <details> <summary><strong>📁 filesystem - Acceso al Sistema de Archivos</strong></summary> **Instalación:** ```bash claude-mcp install filesystem ``` **Capacidades:** - Lectura y escritura de archivos de texto - Navegación de directorios - Creación y eliminación de archivos/carpetas - Búsqueda de archivos por nombre o contenido **Configuración segura:** - Solo accede a directorios específicamente autorizados - No puede ejecutar comandos del sistema - Logs de todas las operaciones de archivo **Casos de uso típicos:** - Análisis de código fuente - Edición de archivos de configuración - Gestión de documentos - Organización de proyectos </details> <details> <summary><strong>🌐 brave-search - Búsqueda Web</strong></summary> **Instalación:** ```bash claude-mcp install brave-search ``` **Configuración de API Key:** 1. Visita [Brave Search API](https://brave.com/search/api/) 2. Crea una cuenta y obtén tu API key 3. Configura la key: `claude-mcp configure brave-search --api-key YOUR_KEY` **Capacidades:** - Búsquedas web en tiempo real - Resultados sin sesgos de personalización - Respeto por la privacidad del usuario - Integración con conversaciones de Claude </details> <details> <summary><strong>🐙 github - Integración con GitHub</strong></summary> **Estado:** En desarrollo activo **Capacidades planificadas:** - Acceso a repositorios públicos y privados - Lectura de issues y pull requests - Análisis de código y commits - Integración con GitHub Actions </details> <details> <summary><strong>📊 sqlite - Acceso a Bases de Datos</strong></summary> **Estado:** En desarrollo activo **Capacidades planificadas:** - Consultas SQL seguras - Análisis de esquemas de base de datos - Generación de reportes - Migración de datos </details> <details> <summary><strong>🔗 web-scraper - Extracción de Contenido Web</strong></summary> **Estado:** En desarrollo activo **Capacidades planificadas:** - Extracción inteligente de contenido - Respeto por robots.txt - Procesamiento de JavaScript - APIs para sitios comunes </details> --- ## 🛠️ **Arquitectura del Sistema** ### **Componentes Principales** ``` claude-desktop-enhanced/ ├── 🚀 enhanced-launcher.sh # Launcher inteligente con detección de entorno ├── 🔧 claude-mcp-manager.sh # Sistema de gestión de servidores MCP ├── 💾 backup-system.sh # Sistema de backup y recuperación ├── 🖥️ wayland-detector.sh # Detección y optimización de display server ├── 📦 PKGBUILD # Configuración de paquete para Arch Linux └── 🎨 Desktop Integration # Iconos, .desktop files, integración del sistema ``` ### **Flujo de Ejecución** ```mermaid graph TD A[Usuario ejecuta claude-desktop-enhanced] --> B[enhanced-launcher.sh] B --> C[Detección de entorno] C --> D[wayland-detector.sh] D --> E{¿Wayland o X11?} E -->|Wayland| F[Aplicar flags de Wayland] E -->|X11| G[Aplicar flags de X11] F --> H[Configurar entorno] G --> H H --> I[Verificar configuración MCP] I --> J[Lanzar Electron con app.asar] J --> K[Claude Desktop Enhanced corriendo] ``` ### **Tecnologías Fundamentales** **Base de la aplicación:** - **Electron:** Motor de aplicación multiplataforma - **Claude Desktop oficial:** Aplicación base de Anthropic - **patchy-cnb:** Capa de compatibilidad para bindings nativos de Linux **Herramientas de gestión:** - **Bash scripting:** Para automatización e integración del sistema - **JSON:** Para gestión de configuraciones MCP - **systemd:** Para integración con servicios del sistema - **XDG standards:** Para ubicación correcta de archivos y configuraciones **Empaquetado y distribución:** - **PKGBUILD:** Sistema nativo de paquetes de Arch Linux - **AUR:** Arch User Repository para distribución - **Git:** Control de versiones y colaboración ### **Seguridad y Permisos** **Modelo de seguridad:** - **Principio de menor privilegio:** Cada servidor MCP solo tiene acceso a lo estrictamente necesario - **Sandboxing:** Electron ejecuta con flags de seguridad apropiados - **Auditoría:** Logs de todas las operaciones importantes - **Backups automáticos:** Protección contra pérdida de configuración **Gestión de permisos:** - **Configuración de usuario:** Almacenada en `~/.config/Claude-Enhanced/` - **Recursos del sistema:** Acceso de solo lectura desde `/usr/lib/claude-desktop-enhanced/` - **Configuración global:** Plantillas en `/etc/claude-desktop-enhanced/` --- ## 🔧 **Solución de Problemas** ### **Problemas Comunes y Soluciones** <details> <summary><strong>❌ La aplicación no inicia</strong></summary> **Diagnóstico paso a paso:** 1. **Verificar instalación:** ```bash pacman -Qi claude-desktop-enhanced which claude-desktop-enhanced ``` 2. **Verificar dependencias:** ```bash which electron electron --version ``` 3. **Revisar permisos:** ```bash ls -la /usr/bin/claude-desktop-enhanced ls -la /usr/lib/claude-desktop-enhanced/ ``` 4. **Ejecutar con debugging:** ```bash ELECTRON_ENABLE_LOGGING=1 claude-desktop-enhanced ``` **Soluciones comunes:** - **Electron faltante:** `sudo pacman -S electron` - **Permisos incorrectos:** `sudo chmod +x /usr/bin/claude-desktop-enhanced` - **Configuración corrupta:** `rm -rf ~/.config/Claude-Enhanced/ && claude-desktop-enhanced` </details> <details> <summary><strong>🔧 Servidores MCP no funcionan</strong></summary> **Verificación de servidores MCP:** 1. **Listar configuración actual:** ```bash claude-mcp list cat ~/.config/Claude-Enhanced/claude_desktop_config.json ``` 2. **Probar servidor manualmente:** ```bash npx -y @modelcontextprotocol/server-filesystem /home ``` 3. **Verificar Node.js y npm:** ```bash node --version npm --version which npx ``` **Soluciones comunes:** - **Node.js faltante:** `sudo pacman -S nodejs npm` - **Configuración inválida:** `claude-mcp restore` - **Permisos de directorio:** Verificar que Claude tenga acceso a los directorios configurados </details> <details> <summary><strong>🖥️ Problemas de display</strong></summary> **Diagnóstico de entorno gráfico:** 1. **Verificar detección de entorno:** ```bash /usr/share/claude-desktop-enhanced/wayland-detector.sh info ``` 2. **Información del sistema gráfico:** ```bash echo "Display server: $XDG_SESSION_TYPE" echo "Wayland display: $WAYLAND_DISPLAY" echo "X11 display: $DISPLAY" ``` 3. **Probar con flags específicos:** ```bash # Forzar X11 export WAYLAND_DISPLAY="" claude-desktop-enhanced # Forzar Wayland claude-desktop-enhanced --enable-features=UseOzonePlatform --ozone-platform=wayland ``` **Soluciones por entorno:** - **Sway:** Añadir `exec claude-desktop-enhanced` a la configuración de Sway - **Hyprland:** Verificar que `XDG_CURRENT_DESKTOP=Hyprland` - **GNOME:** Instalar `gnome-shell-extension-appindicator` para el tray icon - **Escalado HiDPI:** Configurar factor de escala en las preferencias de Claude </details> ### **Herramientas de Diagnóstico Avanzado** ```bash # Diagnóstico completo del sistema claude-mcp diagnose # Información detallada del entorno /usr/share/claude-desktop-enhanced/wayland-detector.sh info # Estadísticas del sistema de backup /usr/share/claude-desktop-enhanced/backup-system.sh stats # Logs en tiempo real journalctl --user -f | grep claude # Test de conectividad de red (para servidores MCP que lo requieren) curl -s https://api.brave.com/search || echo "Sin conexión a Brave Search" ``` ### **Reset Completo del Sistema** Si tienes problemas persistentes, puedes hacer un reset completo: ```bash # Backup de configuración actual (por si acaso) cp -r ~/.config/Claude-Enhanced/ ~/claude-config-backup-$(date +%Y%m%d) # Reset completo rm -rf ~/.config/Claude-Enhanced/ rm -rf ~/.claude-mcp-backup/ # Reinstalar configuración por defecto claude-desktop-enhanced # Esto recreará la configuración por defecto claude-mcp install filesystem ``` --- ## 🗺️ **Roadmap** ### **Versión 0.11.x - Próximas Mejoras (Q2 2025)** - [ ] **🐍 Integración con Python SDK de Anthropic** - Herramientas de diagnóstico que interactúan directamente con Claude - Validación automática de configuraciones MCP usando la API - Sistema de health-checking inteligente - [ ] **🎨 Interfaz Gráfica de Gestión MCP** - GUI nativa usando PyQt6 para gestión visual de servidores - Monitor en tiempo real del estado de servidores MCP - Configuración visual de API keys y permisos - [ ] **🔧 Servidores MCP Adicionales** - GitHub completo (issues, PRs, repositorios) - SQLite con interfaz visual de consultas - Web scraper con respeto a robots.txt - Calculator para matemáticas complejas ### **Versión 0.12.x - Expansión de Plataforma (Q3 2025)** - [ ] **🌍 Soporte Multi-Distribución** - Paquetes para Ubuntu/Debian (.deb) - Paquetes para Fedora/RHEL (.rpm) - AppImage universal para todas las distribuciones - Instalador automático que detecta la distribución - [ ] **☁️ Sincronización en la Nube** - Backup automático de configuraciones en servicios cloud - Sincronización entre múltiples dispositivos - Importación/exportación de configuraciones completas - [ ] **🔌 Sistema de Plugins Extensible** - API para desarrolladores de terceros - Marketplace de plugins comunitarios - Plugins para editores (VSCode, Vim, Emacs) ### **Versión 1.0.x - Estabilidad y Madurez (Q4 2025)** - [ ] **🏢 Características Empresariales** - Gestión centralizada de configuraciones - Políticas de seguridad configurables - Auditoría completa de acciones - Integración con sistemas de autenticación corporativa - [ ] **🤖 Automatización Avanzada** - Detección automática de contexto de trabajo - Sugerencias inteligentes de servidores MCP - Optimización automática basada en patrones de uso - Integración con flujos de trabajo de desarrollo - [ ] **📊 Analytics y Monitoreo** - Dashboard de uso y rendimiento - Métricas de productividad - Reportes de utilización de recursos - Alertas proactivas de problemas ### **Contribuye al Roadmap** ¿Tienes ideas para el futuro de Claude Desktop Enhanced? - **🗳️ Vota por características:** [GitHub Discussions](https://github.com/ayres/claude-desktop-enhanced/discussions/categories/ideas) - **💡 Propón nuevas ideas:** [Crear nueva propuesta](https://github.com/ayres/claude-desktop-enhanced/discussions/new?category=ideas) - **🐛 Reporta bugs:** [Issues de GitHub](https://github.com/ayres/claude-desktop-enhanced/issues/new) - **💻 Contribuye con código:** Ver [guía de contribución](#-contribuir) --- ## 🤝 **Contribuir** Claude Desktop Enhanced es un proyecto de código abierto que prospera gracias a las contribuciones de la comunidad. Independientemente de tu nivel de experiencia técnica, hay maneras significativas de contribuir al proyecto. ### **🚀 Primeros Pasos para Contribuyentes** **Para nuevos contribuyentes:** 1. **🍴 Fork el repositorio** en GitHub 2. **📋 Lee nuestras guías:** [CONTRIBUTING.md](CONTRIBUTING.md) para detalles completos 3. **🔍 Encuentra un issue:** Busca etiquetas `good-first-issue` o `help-wanted` 4. **💬 Pregunta:** No dudes en comentar en issues si necesitas aclaración **Configuración del entorno de desarrollo:** ```bash # Fork y clona tu copia git clone https://github.com/TU-USUARIO/claude-desktop-enhanced.git cd claude-desktop-enhanced # Configura el repositorio original como upstream git remote add upstream https://github.com/ayres/claude-desktop-enhanced.git # Crea una rama para tu contribución git checkout -b feature/mi-nueva-caracteristica # Haz cambios, prueba localmente makepkg -sri # Commit y push git commit -am "Añadir nueva característica increíble" git push origin feature/mi-nueva-caracteristica ``` ### **🎯 Áreas Donde Necesitamos Ayuda** <details> <summary><strong>🧪 Testing y Quality Assurance</strong></summary> **Testing en diferentes entornos:** - Probar en diferentes compositores de Wayland (Sway, Hyprland, GNOME, KDE) - Verificar funcionamiento en diferentes window managers de X11 - Testing en hardware variado (diferentes GPUs, resoluciones, etc.) **Casos de prueba específicos:** - Instalación limpia en sistemas nuevos - Migración desde Claude Desktop oficial - Funcionamiento con diferentes configuraciones de servidores MCP - Performance en sistemas con recursos limitados **Cómo contribuir:** - Reportar bugs con información detallada del sistema - Crear casos de prueba reproducibles - Validar correcciones en tu entorno específico </details> <details> <summary><strong>📝 Documentación y Tutoriales</strong></summary> **Documentación técnica:** - Mejorar comentarios en scripts de shell - Documentar APIs internas para desarrolladores - Crear diagramas de arquitectura del sistema **Guías para usuarios:** - Tutoriales paso a paso para casos de uso específicos - Guías de configuración para compositores menos comunes - Ejemplos de configuraciones avanzadas de MCP **Cómo contribuir:** - Mejorar explicaciones confusas en la documentación existente - Crear nuevos tutoriales basados en tu experiencia - Traducir documentación a otros idiomas </details> <details> <summary><strong>💻 Desarrollo de Código</strong></summary> **Scripts de shell y automatización:** - Mejorar detección de entornos específicos - Añadir soporte para nuevos compositores - Optimizar rendimiento de scripts existentes **Integración del sistema:** - Mejorar manejo de archivos .desktop - Optimizar integración con systemd - Añadir soporte para más distribuciones Linux **Herramientas de gestión MCP:** - Implementar nuevos servidores MCP - Mejorar validación de configuraciones - Añadir herramientas de monitoreo **Cómo contribuir:** - Revisar issues marcados como `bug` o `enhancement` - Proponer mejoras de arquitectura - Implementar características del roadmap </details> <details> <summary><strong>🎨 Diseño y UX</strong></summary> **Experiencia de usuario:** - Mejorar mensajes de error y feedback al usuario - Diseñar flujos de configuración más intuitivos - Crear iconografía y elementos visuales **Interfaz gráfica futura:** - Diseñar mockups para la GUI de gestión MCP - Crear especificaciones de UX para nuevas características - Planificar flujos de trabajo para usuarios no técnicos **Cómo contribuir:** - Crear mockups y prototipos - Proponer mejoras en la experiencia de usuario - Diseñar elementos gráficos e iconos </details> ### **📊 Estadísticas de Contribución** [](https://github.com/ayres/claude-desktop-enhanced/graphs/contributors) [](https://github.com/ayres/claude-desktop-enhanced/issues) [](https://github.com/ayres/claude-desktop-enhanced/pulls) ### **🏆 Reconocimiento a Contribuyentes** Valoramos enormemente cada contribución, desde reportes de bugs hasta grandes características. Todos los contribuyentes son reconocidos en: - **README:** Sección de reconocimientos actualizada - **CHANGELOG:** Créditos en notas de release - **GitHub:** Perfil de contribuyente en el repositorio - **Releases:** Mención especial en anuncios importantes --- ## ❓ **Preguntas Frecuentes** <details> <summary><strong>🤔 ¿Es seguro usar Claude Desktop Enhanced?</strong></summary> **Sí, es completamente seguro.** Claude Desktop Enhanced está basado en la aplicación oficial de Anthropic y utiliza únicamente componentes de código abierto para la compatibilidad con Linux. **Medidas de seguridad:** - Usa la aplicación oficial de Claude como base (solo se modifican bindings de compatibilidad) - Todo el código de modificación es open source y auditable - Los servidores MCP funcionan con principio de menor privilegio - Backups automáticos protegen contra pérdida de datos - Sin telemetría o tracking adicional más allá de lo que incluye Claude oficial </details> <details> <summary><strong>🔧 ¿Qué diferencias hay con Claude Desktop oficial?</strong></summary> **Ventajas de Claude Desktop Enhanced:** - **Nativo para Linux:** No necesita Wine o emulación - **Gestión MCP integrada:** Instalación de servidores con un comando - **Detección automática de entorno:** Optimización para Wayland/X11 - **Sistema de backup:** Protección automática de configuraciones - **Integración con Arch:** Instalación y actualizaciones estándar **Lo que mantiene igual:** - Funcionalidad core de Claude (conversaciones, análisis, etc.) - Interfaz de usuario idéntica - Compatibilidad con todas las características de Claude - Mismo nivel de privacidad y seguridad </details> <details> <summary><strong>💰 ¿Necesito una suscripción de Claude Pro?</strong></summary> **No necesariamente.** Claude Desktop Enhanced funciona con cualquier tipo de cuenta de Claude: - **Claude Free:** Funcionalidad completa con límites estándar de uso - **Claude Pro:** Sin límites, más capacidades, soporte prioritario - **Claude Team:** Características empresariales adicionales **Nota importante:** Los límites de uso están determinados por tu suscripción de Claude con Anthropic, no por Claude Desktop Enhanced. </details> <details> <summary><strong>🔄 ¿Cómo migro desde Claude Desktop oficial?</strong></summary> **La migración es automática.** Claude Desktop Enhanced detecta automáticamente configuraciones existentes de Claude Desktop oficial y las importa sin pérdida de datos. **Proceso de migración:** 1. Instala Claude Desktop Enhanced normalmente 2. En el primer arranque, se detectan configuraciones existentes 3. Se importan automáticamente configuraciones, historial y preferencias 4. Se crea un backup de la configuración original por seguridad 5. Puedes usar ambas versiones simultáneamente si lo deseas </details> <details> <summary><strong>🐛 ¿Qué hago si encuentro un bug?</strong></summary> **Reporta el bug en GitHub Issues:** 1. **Busca primero:** Verifica si el bug ya fue reportado 2. **Información del sistema:** Incluye tu distro, compositor, versión de Claude 3. **Pasos para reproducir:** Describe exactamente cómo reproducir el problema 4. **Logs:** Incluye output de `ELECTRON_ENABLE_LOGGING=1 claude-desktop-enhanced` 5. **Configuración:** Comparte tu configuración MCP (sin API keys) **Para ayuda inmediata:** - Intenta `claude-mcp diagnose` para identificar problemas comunes - Restaura configuración con `claude-mcp restore` - Consulta la [sección de troubleshooting](#-solución-de-problemas) </details> <details> <summary><strong>🚀 ¿Cómo puedo contribuir sin saber programar?</strong></summary> **Hay muchas maneras de contribuir sin código:** - **Testing:** Prueba la aplicación en tu entorno y reporta problemas - **Documentación:** Mejora README, crea tutoriales, traduce contenido - **Diseño:** Crea iconos, mejora UX, diseña interfaces - **Comunidad:** Ayuda a otros usuarios en Discussions, comparte configuraciones - **Feedback:** Sugiere características, mejoras de usabilidad - **Promoción:** Comparte el proyecto, escribe reviews, crea contenido **Cada contribución es valiosa** y ayuda a hacer el proyecto mejor para todos. </details> --- ## 🏆 **Reconocimientos** Claude Desktop Enhanced existe gracias al trabajo excepcional de desarrolladores y comunidades que han hecho posible ejecutar Claude Desktop en Linux. Reconocemos especialmente: ### **🎯 Contribuyentes Técnicos Principales** - **[k3d3](https://github.com/k3d3)** - Creador original de `patchy-cnb` y pionero en la portabilidad de Claude Desktop a Linux. Su trabajo fundamental hizo posible ejecutar aplicaciones Electron con bindings nativos de Windows en sistemas Linux. - **[jkoelker](https://github.com/jkoelker)** - Mantenedor de `claude-desktop-native` y contribuyente clave en mejoras de estabilidad y rendimiento. Sus optimizaciones han sido fundamentales para la experiencia de usuario en Linux. - **[aaddrick](https://github.com/aaddrick)** - Desarrollador de `claude-desktop-arch` e innovador en técnicas de extracción desde instaladores de Windows. Su trabajo en automatización de builds ha sido inspiración directa para este proyecto. - **[emsi](https://github.com/emsi)** - Contribuyente en correcciones de interfaz de usuario y patches específicos para mejorar la experiencia visual en diferentes entornos de escritorio Linux. ### **🏢 Organizaciones y Proyectos** - **[Anthropic Team](https://anthropic.com)** - Por crear Claude Desktop y el protocolo MCP (Model Context Protocol), estableciendo las bases para una nueva generación de asistentes de IA extensibles. - **[Arch Linux Community](https://archlinux.org)** - Por mantener un sistema de paquetes excepcional y estándares de calidad que hacen posible distribuciones como esta. El AUR es verdaderamente una joya de la comunidad open source. - **[Electron Team](https://electronjs.org)** - Por crear un framework que permite aplicaciones nativas multiplataforma manteniendo la flexibilidad de tecnologías web. ### **🌟 Comunidad y Inspiración** **Proyectos que han inspirado decisiones de diseño:** - **[Sway](https://swaywm.org)** - Por demostrar que software moderno puede ser eficiente, elegante y completamente funcional en Wayland - **[Hyprland](https://hyprland.org)** - Por crear una experiencia de compositor que combina potencia con estética - **[yay](https://github.com/Jguer/yay)** - Por establecer el estándar de experiencia de usuario en helpers de AUR **Filosofías de desarrollo adoptadas:** - **Unix Philosophy:** "Haz una cosa y hazla bien" - cada componente tiene una responsabilidad clara - **Arch Way:** Simplicidad, elegancia, versatilidad, y enfoque en el usuario - **Open Source First:** Transparencia total, colaboración abierta, y beneficio comunitario ### **🎓 Recursos de Aprendizaje** Este proyecto no habría sido posible sin excelentes recursos de la comunidad: - **[Arch Wiki](https://wiki.archlinux.org)** - La documentación más completa y confiable para Linux - **[MCP Documentation](https://modelcontextprotocol.io)** - Documentación oficial del protocolo que hace posible la extensibilidad - **[Wayland Book](https://wayland-book.com)** - Para entender los fundamentos de la modernización de display servers ### **💖 Agradecimientos Especiales** - **Beta testers y early adopters** - Los valientes usuarios que probaron versiones tempranas y reportaron bugs críticos - **Traductores de la comunidad** - Por hacer el proyecto accesible a usuarios de habla hispana y otros idiomas - **Moderadores de forums** - En r/archlinux, forums de Arch, y comunidades de Linux que han ayudado a usuarios con problemas - **Desarrolladores de AUR helpers** - Por crear herramientas que hacen la experiencia de AUR accessible y confiable ### **🌍 Impacto en la Comunidad** Claude Desktop Enhanced representa más que software; es un ejemplo de cómo la comunidad Linux puede tomar herramientas excelentes y adaptarlas para crear experiencias incluso mejores. Cada usuario que instala, cada bug reportado, cada sugerencia de mejora contribuye a un ecosistema donde la excelencia técnica se combina con accesibilidad y usabilidad. **Estadísticas de impacto:** - Múltiples distribuciones soportadas a partir de una base sólida en Arch - Reducción significativa en tiempo de configuración inicial para nuevos usuarios - Automatización de tareas que antes requerían conocimiento técnico avanzado - Adopción de estándares modernos (Wayland, MCP) sin sacrificar compatibilidad --- ## 📄 **Licencia** Claude Desktop Enhanced usa un esquema de licenciamiento dual que respeta tanto el software propietario subyacente como las contribuciones de código abierto: ### **📋 Resumen de Licencias** **Scripts de construcción, herramientas de gestión y mejoras:** - **Código original de este proyecto:** Dual-licensed bajo [MIT](LICENSE-MIT) y [Apache 2.0](LICENSE-APACHE) - **Elección de licencia:** Puedes elegir usar el código bajo los términos de MIT o Apache 2.0, según prefieras **Componentes de terceros:** - **Claude Desktop:** Propietario (© Anthropic, Inc.) - **patchy-cnb:** MIT/Apache 2.0 (por k3d3) - **Electron:** MIT License ### **🔍 ¿Qué Significa Esto Para Ti?** **Si eres usuario final:** - Puedes usar Claude Desktop Enhanced libremente para cualquier propósito - No hay restricciones adicionales más allá de las del Claude Desktop oficial - El código de automatización e integración es completamente libre **Si eres desarrollador que quiere contribuir:** - Tus contribuciones serán también dual-licensed MIT/Apache 2.0 - Puedes usar nuestro código en tus propios proyectos bajo términos muy permisivos - Puedes crear derivados comerciales o no comerciales **Si quieres crear un fork o derivado:** - Puedes usar todo nuestro código de integración libremente - Debes respetar la licencia propietaria de Claude Desktop de Anthropic - Recomendamos mantener la misma estructura de licenciamiento dual ### **📚 Archivos de Licencia Completos** - **[MIT License](LICENSE-MIT)** - Licencia simple y permisiva - **[Apache 2.0 License](LICENSE-APACHE)** - Licencia con protecciones adicionales de patentes - **[Anthropic Terms](https://console.anthropic.com/legal/consumer-terms)** - Términos de Claude Desktop ### **⚖️ Filosofía de Licenciamiento** **Por qué dual-licensing:** Ofrecemos tanto MIT como Apache 2.0 para maximizar la compatibilidad con otros proyectos. MIT es extremadamente simple y compatible con prácticamente todo, mientras Apache 2.0 ofrece protecciones adicionales contra problemas de patentes que algunos proyectos empresariales requieren. **Compromiso con el código abierto:** Creemos firmemente que las herramientas que mejoran software existente deben ser abiertas y reutilizables. Al hacer nuestro código disponible bajo licencias permisivas, habilitamos a otros desarrolladores a crear herramientas similares para otras aplicaciones o plataformas. **Respeto por el software propietario:** Aunque creemos en el código abierto, también respetamos el derecho de Anthropic a mantener Claude Desktop bajo una licencia propietaria. Nuestro trabajo se enfoca únicamente en integración y automatización, no en reemplazar o modificar funcionalidad core. --- <div align="center"> **🌟 ¡Dale una estrella si Claude Desktop Enhanced te ha sido útil! 🌟** [](https://github.com/ayres/claude-desktop-enhanced/stargazers) [](https://github.com/ayres/claude-desktop-enhanced/network/members) [](https://github.com/ayres/claude-desktop-enhanced/watchers) *Hecho con ❤️ para la comunidad de Arch Linux* **[🏠 Inicio](#claude-desktop-enhanced-for-arch-linux) • [📦 Instalar](#-instalación) • [🤝 Contribuir](#-contribuir) • [💬 Discusiones](https://github.com/ayres/claude-desktop-enhanced/discussions)** </div> --- > **Nota:** Claude Desktop Enhanced es un proyecto de la comunidad y no está oficialmente afiliado con Anthropic, Inc. Claude Desktop es marca registrada de Anthropic, Inc.