Hugging Face's logo

SaylorTwift
/
opencode

agent
coding-agent
cli
llm
typescript
tool-use
Model card Files
xet
 Community
opencode
File size: 3,676 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: Usando OpenCode en su navegador.
---

OpenCode puede ejecutarse como una aplicaci贸n web en su navegador, brindando la misma poderosa experiencia de codificaci贸n de IA sin necesidad de una terminal.

![OpenCode Web - Nueva sesi贸n](../../../assets/web/web-homepage-new-session.png)

## Empezar

Inicie la interfaz web ejecutando:

```bash
opencode web
```

Esto inicia un servidor local en `127.0.0.1` con un puerto disponible aleatorio y abre autom谩ticamente OpenCode en su navegador predeterminado.

:::caution
Si no se establece `OPENCODE_SERVER_PASSWORD`, el servidor no ser谩 seguro. Esto est谩 bien para uso local, pero debe configurarse para acceso a la red.
:::

:::tip[Windows Usuarios]
Para obtener la mejor experiencia, ejecute `opencode web` desde [WSL](/docs/windows-wsl) en lugar de PowerShell. Esto garantiza el acceso adecuado al sistema de archivos y la integraci贸n del terminal.
:::

---

## Configuraci贸n

Puede configurar el servidor web usando indicadores de l铆nea de comando o en su [archivo de configuraci贸n](/docs/config).

### Puerto

De forma predeterminada, OpenCode elige un puerto disponible. Puede especificar un puerto:

```bash
opencode web --port 4096
```

### Nombre de host

De forma predeterminada, el servidor se vincula a `127.0.0.1` (solo localhost). Para hacer que OpenCode sea accesible en su red:

```bash
opencode web --hostname 0.0.0.0
```

Al usar `0.0.0.0`, OpenCode mostrar谩 direcciones locales y de red:

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

### Descubrimiento de mDNS

Habilite mDNS para que su servidor sea reconocible en la red local:

```bash
opencode web --mdns
```

Esto establece autom谩ticamente el nombre de host en `0.0.0.0` y anuncia el servidor como `opencode.local`.

Puede personalizar el nombre de dominio mDNS para ejecutar varias instancias en la misma red:

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

### CORS

Para permitir dominios adicionales para CORS (煤til para interfaces personalizadas):

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

### Autenticaci贸n

Para proteger el acceso, establezca una contrase帽a utilizando la variable de entorno `OPENCODE_SERVER_PASSWORD`:

```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```

El nombre de usuario predeterminado es `opencode` pero se puede cambiar con `OPENCODE_SERVER_USERNAME`.

---

## Usar la interfaz web

Una vez iniciada, la interfaz web proporciona acceso a sus sesiones OpenCode.

### Sesiones

Vea y administre sus sesiones desde la p谩gina de inicio. Puedes ver sesiones activas e iniciar otras nuevas.

![OpenCode Web - Sesi贸n activa](../../../assets/web/web-homepage-active-session.png)

### Estado del servidor

Haga clic en "Ver servidores" para ver los servidores conectados y su estado.

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

---

## Adjuntar una terminal

Puede conectar un terminal TUI a un servidor web en ejecuci贸n:

```bash
# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096
```

Esto le permite utilizar la interfaz web y el terminal simult谩neamente, compartiendo las mismas sesiones y estados.

---

## Archivo de configuraci贸n

Tambi茅n puede configurar los ajustes del servidor en su archivo de configuraci贸n `opencode.json`:

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

Los indicadores de la l铆nea de comando tienen prioridad sobre la configuraci贸n del archivo de configuraci贸n.