Web

OpenCode 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:

opencode web

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

Attenzione

Se OPENCODE_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 opencode 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, OpenCode sceglie una porta disponibile. Puoi specificare una porta:

opencode web --port 4096

Nome host

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

opencode web --hostname 0.0.0.0

Usando 0.0.0.0, OpenCode 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:

opencode web --mdns

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

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

opencode web --mdns --mdns-domain myproject.local

CORS

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

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

Autenticazione

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

OPENCODE_SERVER_PASSWORD=secret opencode web

Lo username predefinito e opencode, ma puo essere cambiato con OPENCODE_SERVER_USERNAME.

---

Usa l’interfaccia web

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

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
opencode web --port 4096

# In un altro terminale, collega la TUI
opencode 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 opencode.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.