Hugging Face's logo

SaylorTwift
/
opencode

agent
coding-agent
cli
llm
typescript
tool-use
Model card Files
xet
 Community
opencode
File size: 3,601 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: Korzystanie z opencode w przeglądarce.
---

opencode może działać jako aplikacja internetowa w przeglądarce, zapewniając takie same możliwości kodowania AI bez konieczności korzystania z terminala.

![Sieć opencode - Nowa sesja](../../../assets/web/web-homepage-new-session.png)

## Pierwsze kroki

Uruchom interfejs sieciowy, uruchamiając:

```bash
opencode web
```

Spowoduje to uruchomienie lokalnego serwera na `127.0.0.1` z losowo dostępnym portem i automatyczne otwarcie opencode w domyślnej przeglądarce.

:::caution
Jeśli `OPENCODE_SERVER_PASSWORD` nie jest ustawione, serwer będzie niezabezpieczony. Jest to dobre rozwiązanie do użytku lokalnego, ale powinno być ustawione na dostęp do sieci.
:::

:::tip[Windows Users]
Aby uzyskać najlepsze wyniki, uruchom `opencode web` z [WSL](/docs/windows-wsl) zamiast programu PowerShell. Zapewnia to prawidłowy dostęp do systemu plików i integrację terminala.
:::

---

## Konfiguracja

Możesz skonfigurować serwer WWW za pomocą flag wiersza poleceń lub w [pliku konfiguracyjnym] (./config).

### Port

Domyślnie opencode wybiera dostępny port. Możesz określić port:

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

### Nazwa hosta

Domyślnie serwer łączy się z `127.0.0.1` (tylko localhost). Aby udostępnić opencode w swojej sieci:

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

Podczas korzystania z `0.0.0.0` opencode wyświetli zarówno adresy lokalne, jak i sieciowe:

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

### Wykrywanie mDNS

Włącz mDNS, aby Twój serwer był wykrywalny w sieci lokalnej:

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

To automatycznie ustawia nazwę hosta na `0.0.0.0` i anonsuje serwer jako `opencode.local`.

Możesz dostosować nazwę domeny mDNS, aby uruchamiała wiele instancji w tej samej sieci:

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

### CORS

Aby zezwolić na dodatkowe domeny dla CORS (przydatne w przypadku niestandardowych interfejsów):

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

### Uwierzytelnianie

Aby chronić dostęp, ustaw hasło za pomocą zmiennej środowiskowej `OPENCODE_SERVER_PASSWORD`:

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

Domyślna nazwa użytkownika to `opencode`, ale można ją zmienić za pomocą `OPENCODE_SERVER_USERNAME`.

---

## Korzystanie z interfejsu internetowego

Po uruchomieniu interfejs sieciowy zapewnia dostęp do sesji opencode.

### Sesje

Przeglądaj sesje i zarządzaj nimi ze strony głównej. Możesz zobaczyć aktywne sesje i rozpocząć nowe.

![opencode Web - Aktywna sesja](../../../assets/web/web-homepage-active-session.png)

### Stan serwera

Kliknij „Zobacz serwery”, aby wyświetlić podłączone serwery i ich status.

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

---

## Podłączanie terminala

Możesz podłączyć terminal TUI do działającego serwera WWW:

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

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

Umożliwia to jednoczesne korzystanie z interfejsu sieciowego i terminala, współdzieląc te same sesje i stan.

---

## Plik konfiguracyjny

Możesz także skonfigurować ustawienia serwera w pliku konfiguracyjnym `opencode.json`:

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

Flagi wiersza poleceń mają pierwszeństwo przed ustawieniami pliku konfiguracyjnego.