Windows (WSL)

Anche se AicippY puo essere eseguito direttamente su Windows, consigliamo di usare Windows Subsystem for Linux (WSL) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di AicippY.

Perche WSL?

WSL offre prestazioni migliori del file system, supporto completo del terminale e compatibilita con gli strumenti di sviluppo su cui AicippY fa affidamento.

---

Configurazione

1. Installa WSL

   Se non l’hai ancora fatto, installa WSL seguendo la guida ufficiale Microsoft.

2. Installa AicippY in WSL

   Dopo aver configurato WSL, apri il terminale WSL e installa AicippY usando uno dei metodi di installazione.

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

3. Usa AicippY da WSL

   Vai nella directory del progetto (accedi ai file Windows tramite /mnt/c/, /mnt/d/, ecc.) ed esegui AicippY.

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

---

App desktop + server WSL

Se preferisci usare l’app desktop di AicippY ma vuoi eseguire il server in WSL:

1. Avvia il server in WSL con --hostname 0.0.0.0 per consentire connessioni esterne:

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

2. Collega l’app desktop a http://localhost:4096

Nota

Se localhost non funziona nella tua configurazione, usa l’indirizzo IP di WSL (da WSL: hostname -I) e collega http://<wsl-ip>:4096.

Attenzione

Quando usi --hostname 0.0.0.0, imposta AICIPPY_CODE_SERVER_PASSWORD per proteggere il server.

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

---

Client web + WSL

Per la migliore esperienza web su Windows:

1. Esegui aicippy-code web nel terminale WSL invece che in PowerShell:

   aicippy-code web --hostname 0.0.0.0

2. Accedi dal browser Windows su http://localhost:<port> (AicippY stampa l’URL)

Eseguire aicippy-code web da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.

---

Accesso ai file Windows

WSL puo accedere a tutti i file Windows tramite la directory /mnt/:

• Unita C: → /mnt/c/
• Unita D: → /mnt/d/
• E cosi via…

Esempio:

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

Consiglio

Per un’esperienza piu fluida, valuta di clonare o copiare il repository nel file system di WSL (per esempio in ~/code/) ed eseguire AicippY li.

---

Suggerimenti

• Tieni AicippY in esecuzione su WSL per i progetti salvati su unita Windows: l’accesso ai file e immediato
• Usa l’estensione WSL di VS Code insieme a AicippY per un flusso di lavoro integrato
• Configurazione e sessioni di AicippY sono salvate nell’ambiente WSL in ~/.local/share/aicippy-code/