Windows (WSL)

AicippY laeuft zwar direkt unter Windows, die beste Erfahrung bekommst du aber mit Windows Subsystem for Linux (WSL). WSL bietet eine Linux-Umgebung, die mit den AicippY-Features nahtlos funktioniert.

Warum WSL?

WSL bietet bessere Dateisystem-Performance, vollstaendige Terminal-Unterstuetzung und hohe Kompatibilitaet mit den Entwicklungswerkzeugen, die AicippY nutzt.

---

Einrichtung

1. Install WSL

   Falls noch nicht geschehen, installiere WSL mit der offiziellen Microsoft-Anleitung.

2. Install AicippY in WSL

   Wenn WSL eingerichtet ist, oeffne dein WSL-Terminal und installiere AicippY mit einer der Installationsmethoden.

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

3. AicippY über WSL verwenden

   Wechsle in dein Projektverzeichnis (Windows-Dateien erreichst du ueber /mnt/c/, /mnt/d/ usw.) und starte AicippY.

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

---

Desktop-App + WSL-Server

Wenn du die AicippY-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest:

1. Starte den Server in WSL mit --hostname 0.0.0.0, damit externe Verbindungen moeglich sind:

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

2. Verbinde die Desktop-App mit http://localhost:4096

Hinweis

Wenn localhost in deiner Umgebung nicht funktioniert, nutze stattdessen die WSL-IP-Adresse (in WSL: hostname -I) und verbinde dich mit http://<wsl-ip>:4096.

Achtung

Wenn du --hostname 0.0.0.0 verwendest, setze AICIPPY_CODE_SERVER_PASSWORD, um den Server zu schuetzen.

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

---

Web-Client + WSL

Fuer die beste Web-Erfahrung unter Windows:

1. Fuehre aicippy-code web im WSL-Terminal aus, nicht in PowerShell:

   aicippy-code web --hostname 0.0.0.0

2. Rufe die URL im Windows-Browser auf unter http://localhost:<port> (AicippY zeigt die URL an)

Wenn du aicippy-code web aus WSL startest, bleiben Dateizugriff und Terminal-Integration sauber. Gleichzeitig ist die Weboberflaeche weiterhin im Windows-Browser erreichbar.

---

Zugriff auf Windows-Dateien

WSL kann ueber das Verzeichnis /mnt/ auf alle Windows-Dateien zugreifen:

• Laufwerk C: -> /mnt/c/
• Laufwerk D: -> /mnt/d/
• usw.

Beispiel:

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

Tipp

Fuer die beste Performance kannst du dein Repo direkt in das WSL-Dateisystem klonen/kopieren (z. B. nach ~/code/) und AicippY dort starten.

---

Tipps

• Lass AicippY in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
• Nutze die WSL-Extension von VS Code fuer einen integrierten Workflow
• AicippY-Konfiguration und Sitzungen liegen in WSL unter ~/.local/share/aicippy-code/