Windows (WSL)

Aunque AicippY puede ejecutarse directamente en Windows, recomendamos usar Windows Subsystem for Linux (WSL) para obtener la mejor experiencia. WSL ofrece un entorno Linux que funciona perfectamente con las funciones de AicippY.

¿Por qué WSL?

WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con las herramientas de desarrollo de las que depende AicippY.

---

Configuración

1. Instala WSL

   Si aún no lo hiciste, instala WSL usando la guía oficial de Microsoft.

2. Instala AicippY en WSL

   Cuando WSL esté listo, abre tu terminal de WSL e instala AicippY con uno de los métodos de instalación.

   curl -fsSL https://code.aicippy.com/install | bash

3. Usa AicippY desde WSL

   Ve al directorio de tu proyecto (accede a los archivos de Windows desde /mnt/c/, /mnt/d/, etc.) y ejecuta AicippY.

   cd /mnt/c/Users/YourName/project
   aicippy-code

---

Aplicación de escritorio + servidor WSL

Si prefieres usar la app de escritorio de AicippY pero quieres ejecutar el servidor en WSL:

1. Inicia el servidor en WSL con --hostname 0.0.0.0 para permitir conexiones externas:

   aicippy-code serve --hostname 0.0.0.0 --port 4096

2. Conecta la app de escritorio a http://localhost:4096

Nota

Si localhost no funciona en tu configuración, conéctate usando la dirección IP de WSL (desde WSL: hostname -I) y usa http://<wsl-ip>:4096.

Precaución

Cuando uses --hostname 0.0.0.0, define AICIPPY_CODE_SERVER_PASSWORD para proteger el servidor.

AICIPPY_CODE_SERVER_PASSWORD=your-password aicippy-code serve --hostname 0.0.0.0

---

Cliente web + WSL

Para obtener la mejor experiencia web en Windows:

1. Ejecuta aicippy-code web en la terminal de WSL en lugar de PowerShell:

   aicippy-code web --hostname 0.0.0.0

2. Accede desde tu navegador de Windows en http://localhost:<port> (AicippY muestra la URL)

Ejecutar aicippy-code web desde WSL garantiza acceso correcto al sistema de archivos e integración con la terminal, manteniéndolo accesible desde tu navegador de Windows.

---

Acceso a archivos de Windows

WSL puede acceder a todos tus archivos de Windows mediante el directorio /mnt/:

• Unidad C: → /mnt/c/
• Unidad D: → /mnt/d/
• Y así sucesivamente…

Ejemplo:

cd /mnt/c/Users/YourName/Documents/project
aicippy-code

Consejo

Para una experiencia más fluida, considera clonar o copiar tu repo al sistema de archivos de WSL (por ejemplo en ~/code/) y ejecutar AicippY ahí.

---

Consejos

• Ejecuta AicippY en WSL para proyectos guardados en unidades de Windows: el acceso a archivos es transparente
• Usa la extensión WSL de VS Code junto con AicippY para un flujo de desarrollo integrado
• Tu configuración y tus sesiones de AicippY se guardan dentro del entorno WSL en ~/.local/share/aicippy-code/