Windows (WSL)

Même si AicippY peut fonctionner directement sur Windows, nous recommandons d’utiliser Windows Subsystem for Linux (WSL) pour la meilleure expérience. WSL fournit un environnement Linux qui s’intègre parfaitement aux fonctionnalités d’AicippY.

Pourquoi WSL?

WSL offre de meilleures performances du système de fichiers, une prise en charge complète du terminal et la compatibilité avec les outils de développement dont AicippY dépend.

---

Configuration

1. Installez WSL

   Si ce n’est pas encore fait, installez WSL à l’aide du guide officiel Microsoft.

2. Installez AicippY dans WSL

   Une fois WSL configuré, ouvrez votre terminal WSL et installez AicippY avec l’une des méthodes d’installation.

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

3. Utilisez AicippY depuis WSL

   Allez dans votre dossier de projet (accédez aux fichiers Windows via /mnt/c/, /mnt/d/, etc.) et lancez AicippY.

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

---

Application bureau + serveur WSL

Si vous préférez utiliser l’application Desktop AicippY tout en exécutant le serveur dans WSL:

1. Démarrez le serveur dans WSL avec --hostname 0.0.0.0 pour autoriser les connexions externes:

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

2. Connectez l’application Desktop à http://localhost:4096

Note

Si localhost ne fonctionne pas dans votre configuration, utilisez plutôt l’adresse IP WSL (depuis WSL: hostname -I) et http://<wsl-ip>:4096.

Attention

Lorsque vous utilisez --hostname 0.0.0.0, définissez AICIPPY_CODE_SERVER_PASSWORD pour sécuriser le serveur.

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

---

Client web + WSL

Pour la meilleure expérience web sous Windows:

1. Exécutez aicippy-code web dans le terminal WSL plutôt que dans PowerShell:

   aicippy-code web --hostname 0.0.0.0

2. Accédez-y depuis votre navigateur Windows à http://localhost:<port> (AicippY affiche l’URL)

Lancer aicippy-code web depuis WSL garantit un accès correct au système de fichiers et une bonne intégration terminal, tout en restant accessible depuis votre navigateur Windows.

---

Accéder aux fichiers Windows

WSL peut accéder à tous vos fichiers Windows via le répertoire /mnt/:

• Lecteur C: → /mnt/c/
• Lecteur D: → /mnt/d/
• Et ainsi de suite…

Exemple:

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

Astuce

Pour une expérience plus fluide, vous pouvez cloner/copier votre dépôt dans le système de fichiers WSL (par exemple sous ~/code/) et y exécuter AicippY.

---

Conseils

• Gardez AicippY dans WSL pour les projets stockés sur des lecteurs Windows: l’accès aux fichiers est fluide
• Utilisez l’extension WSL de VS Code avec AicippY pour un flux de travail intégré
• Votre configuration AicippY et vos sessions sont stockées dans l’environnement WSL à ~/.local/share/aicippy-code/