Hugging Face's logo

SaylorTwift
/
opencode

agent
coding-agent
cli
llm
typescript
tool-use
Model card Files
xet
 Community
opencode
File size: 3,520 Bytes
0dbc9de
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
---
title: Web
description: Usa OpenCode nel browser.
---

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

![OpenCode Web - Nuova sessione](../../../assets/web/web-homepage-new-session.png)

## Per iniziare

Avvia l'interfaccia web eseguendo:

```bash
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.

:::caution
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.
:::

:::tip[Utenti Windows]
Per la migliore esperienza, esegui `opencode web` da [WSL](/docs/windows-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](/docs/config).

### Porta

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

```bash
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:

```bash
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:

```bash
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:

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

### CORS

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

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

### Autenticazione

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

```bash
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.

![OpenCode Web - Sessione attiva](../../../assets/web/web-homepage-active-session.png)

### Stato del server

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

![OpenCode Web - See Servers](../../../assets/web/web-homepage-see-servers.png)

---

## Collegare un terminale

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

```bash
# 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`:

```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.