Web

CodeTutor puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminale.

Per iniziare

Avvia l’interfaccia web eseguendo:

codetutor web

Questo avvia un server locale su 127.0.0.1 con una porta disponibile scelta a caso e apre automaticamente CodeTutor nel browser predefinito.

Attenzione

Se CODETUTOR_SERVER_PASSWORD non e impostata, il server non sara protetto. Va bene per l’uso locale, ma va impostata per l’accesso in rete.

Utenti Windows

Per la migliore esperienza, esegui codetutor web da WSL invece che da PowerShell. Questo garantisce accesso corretto al file system e integrazione col terminale.

---

Configurazione

Puoi configurare il server web con i flag della riga di comando o nel tuo file di config.

Porta

Per impostazione predefinita, CodeTutor sceglie una porta disponibile. Puoi specificare una porta:

codetutor web --port 4096

Nome host

Per impostazione predefinita, il server si lega a 127.0.0.1 (solo localhost). Per rendere CodeTutor accessibile sulla rete:

codetutor web --hostname 0.0.0.0

Usando 0.0.0.0, CodeTutor mostrera sia l’indirizzo locale sia quello di rete:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

Scoperta mDNS

Abilita mDNS per rendere il server individuabile sulla rete locale:

codetutor web --mdns

Questo imposta automaticamente l’hostname a 0.0.0.0 e pubblicizza il server come codetutor.local.

Puoi personalizzare il nome di dominio mDNS per eseguire piu istanze sulla stessa rete:

codetutor web --mdns --mdns-domain myproject.local

CORS

Per consentire domini aggiuntivi per CORS (utile per frontend personalizzati):

codetutor web --cors https://example.com

Autenticazione

Per proteggere l’accesso, imposta una password usando la variabile d’ambiente CODETUTOR_SERVER_PASSWORD:

CODETUTOR_SERVER_PASSWORD=secret codetutor web

Lo username predefinito e codetutor, ma puo essere cambiato con CODETUTOR_SERVER_USERNAME.

---

Usa l’interfaccia web

Una volta avviata, l’interfaccia web ti da accesso alle tue sessioni CodeTutor.

Sessioni

Visualizza e gestisci le sessioni dalla homepage. Puoi vedere le sessioni attive e avviarne di nuove.

Stato del server

Fai clic su “See Servers” per vedere i server connessi e il loro stato.

---

Collegare un terminale

Puoi collegare una TUI da terminale a un server web gia in esecuzione:

# Avvia il web server
codetutor web --port 4096

# In un altro terminale, collega la TUI
codetutor attach http://localhost:4096

Questo ti permette di usare contemporaneamente interfaccia web e terminale, condividendo le stesse sessioni e lo stesso stato.

---

File di configurazione

Puoi anche configurare le impostazioni del server nel file di config codetutor.json:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

I flag della riga di comando hanno precedenza sulle impostazioni del file di config.