@neurocode-ai/web 1.18.8

package/src/content/docs/pl/tui.mdx

@@ -0,0 +1,429 @@
+---
+title: TUI
+description: Korzystanie z interfejsu użytkownika terminala opencode.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+opencode zapewnia interaktywny interfejs terminala lub TUI do pracy nad projektami za pomocą LLM.
+
+Uruchomienie opencode uruchamia TUI dla bieżącego katalogu.
+
+```bash
+opencode
+```
+
+Możesz też uruchomić go dla określonego katalogu roboczego.
+
+```bash
+opencode /path/to/project
+```
+
+Gdy znajdziesz się w TUI, możesz wyświetlić monit za pomocą komunikatu.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## Referencje plików
+
+Możesz odwoływać się do plików w swoich wiadomościach, używając `@`. Spowoduje to rozmyte wyszukiwanie plików w bieżącym katalogu roboczym.
+
+:::tip
+Możesz także użyć `@` do odwoływania się do plików w swoich wiadomościach.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+Zawartość pliku jest automatycznie dodawana do rozmowy.
+
+---
+
+## Polecenia Bash
+
+Rozpocznij wiadomość od `!`, aby uruchomić polecenie shell.
+
+```bash frame="none"
+!ls -la
+```
+
+Dane wyjściowe polecenia są dodawane do konwersacji jako wynik narzędzia.
+
+---
+
+## Komendy
+
+Korzystając z TUI opencode, możesz wpisać `/`, po którym następuje nazwa polecenia, aby szybko wykonać działania. Na przykład:
+
+```bash frame="none"
+/help
+```
+
+Większość poleceń ma również skrót klawiszowy wykorzystujący `ctrl+x` jako klucz wiodący, gdzie `ctrl+x` jest domyślnym klawiszem wiodącym. [Dowiedz się więcej](/docs/keybinds).
+
+Oto wszystkie dostępne slash commands:
+
+---
+
+### connect
+
+Dodaj dostawcę do opencode. Umożliwia wybór dostępnych dostawców i dodanie ich kluczy API.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compact
+
+Kompaktuj bieżącą sesję. _Alias_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**Keybind:** `ctrl+x c`
+
+---
+
+### details
+
+Przełącz szczegóły wykonywania narzędzi.
+
+```bash frame="none"
+/details
+```
+
+**Keybind:** `ctrl+x d`
+
+---
+
+### editor
+
+Otwórz zewnętrzny edytor do tworzenia wiadomości. Używa edytora ustawionego w zmiennej środowiskowej `EDITOR`. [Dowiedz się więcej](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**Keybind:** `ctrl+x e`
+
+---
+
+### exit
+
+Zamknij opencode. _Aliasy_: `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**Keybind:** `ctrl+x q`
+
+---
+
+### export
+
+Wyeksportuj bieżącą rozmowę do Markdown i otwórz ją w domyślnym edytorze. Używa edytora ustawionego w zmiennej środowiskowej `EDITOR`. [Dowiedz się więcej](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**Keybind:** `ctrl+x x`
+
+---
+
+### help
+
+Pokaż okno pomocy.
+
+```bash frame="none"
+/help
+```
+
+**Keybind:** `ctrl+x h`
+
+---
+
+### init
+
+Utwórz lub zaktualizuj plik `AGENTS.md`. [Dowiedz się więcej](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**Keybind:** `ctrl+x i`
+
+---
+
+### models
+
+Lista dostępnych modeli.
+
+```bash frame="none"
+/models
+```
+
+**Keybind:** `ctrl+x m`
+
+---
+
+### new
+
+Rozpocznij nową sesję. _Alias_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**Keybind:** `ctrl+x n`
+
+---
+
+### redo
+
+Ponów cofniętą wcześniej wiadomość. Dostępne tylko po użyciu `/undo`.
+
+:::tip
+Wszystkie zmiany plików również zostaną przywrócone.
+:::
+
+Wewnętrznie używa Git do zarządzania zmianami plików. Więc Twój projekt ** musi
+be a Git repository**.
+
+```bash frame="none"
+/redo
+```
+
+**Keybind:** `ctrl+x r`
+
+---
+
+### sessions
+
+Wyświetl listę i przełączaj się między sesjami. _Aliasy_: `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**Keybind:** `ctrl+x l`
+
+---
+
+### share
+
+Udostępnij bieżącą sesję. [Dowiedz się więcej](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**Keybind:** `ctrl+x s`
+
+---
+
+### themes
+
+Lista dostępnych motywów.
+
+```bash frame="none"
+/theme
+```
+
+**Keybind:** `ctrl+x t`
+
+---
+
+### thinking
+
+Przełącz widoczność bloków myślenia/rozumowania w rozmowie. Po włączeniu tej opcji można zobaczyć proces wnioskowania modelu w przypadku modeli obsługujących myślenie rozszerzone.
+
+:::note
+To polecenie kontroluje jedynie, czy bloki myślowe są **wyświetlane** - nie włącza ani nie wyłącza możliwości wnioskowania modelu. Aby przełączyć rzeczywiste możliwości wnioskowania, użyj `ctrl+t` do przełączania wariantów modelu.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### undo
+
+Cofnij ostatnią wiadomość w rozmowie. Usuwa najnowszą wiadomość użytkownika, wszystkie kolejne odpowiedzi i wszelkie zmiany w plikach.
+
+:::tip
+Wszystkie zmiany plików również zostaną cofnięte.
+:::
+
+Wewnętrznie używa Git do zarządzania zmianami plików. Więc Twój projekt ** musi
+be a Git repository**.
+
+```bash frame="none"
+/undo
+```
+
+**Keybind:** `ctrl+x u`
+
+---
+
+### unshare
+
+Anuluj udostępnianie bieżącej sesji. [Dowiedz się więcej](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Konfiguracja edytora
+
+Zarówno polecenia `/editor`, jak i `/export` korzystają z edytora określonego w zmiennej środowiskowej `EDITOR`.
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+    Aby było to trwałe, dodaj to do swojego profilu shell;
+    `~/.bashrc`, `~/.zshrc`, etc.
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+    Aby ustawić tę opcję na stałe, użyj opcji **Właściwości systemu** > **Środowisko
+    Variables**.
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+    Aby uczynić to trwałym, dodaj to do swojego profilu PowerShell.
+
+  </TabItem>
+</Tabs>
+
+Popularne opcje edytora:
+
+- `code` - Visual Studio Code
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Neovim editor
+- `vim` - Vim editor
+- `nano` - Nano editor
+- `notepad` - Windows Notepad
+- `subl` - Sublime Text
+
+:::note
+Niektóre edytory, takie jak VS Code, należy uruchamiać z flagą `--wait`.
+:::
+
+Niektórzy edytory potrzebują argumentów wiersza poleceń, aby działać w trybie blokowania. Flaga `--wait` blokuje proces edytora aż do jego zamknięcia.
+
+---
+
+## Skonfiguruj
+
+Możesz dostosować zachowanie TUI za pomocą pliku `tui.json` (lub `tui.jsonc`).
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+Jest to oddzielny plik od `opencode.json`, który konfiguruje zachowanie serwera/runtime.
+
+`keybinds` jest łączone z wbudowanymi wartościami domyślnymi, więc wystarczy skonfigurować tylko te skróty, które chcesz zmienić.
+
+### Opcje
+
+- `theme` - Ustawia motyw interfejsu. [Dowiedz się więcej](/docs/themes).
+- `keybinds` - Dostosowuje skróty klawiszowe. [Dowiedz się więcej](/docs/keybinds).
+- `leader_timeout` - Określa, jak długo OpenCode czeka po naciśnięciu leader key. Domyślnie `2000`.
+- `scroll_acceleration.enabled` — Włącz przyspieszenie przewijania w stylu macOS, aby zapewnić płynne, naturalne przewijanie. Po włączeniu prędkość przewijania wzrasta wraz z szybkimi gestami przewijania i pozostaje precyzyjna w przypadku wolniejszych ruchów. **To ustawienie ma pierwszeństwo przed `scroll_speed` i zastępuje je, gdy jest włączone.**
+- `scroll_speed` - Kontroluje szybkość przewijania TUI podczas korzystania z poleceń przewijania (minimum: `0.001`, obsługuje wartości dziesiętne). Wartość domyślna to `3`. **Uwaga: jest to ignorowane, jeśli `scroll_acceleration.enabled` jest ustawione na `true`.**
+- `diff_style` - Steruje renderowaniem różnic. `"auto"` dostosowuje się do szerokości terminala, `"stacked"` zawsze pokazuje układ jednokolumnowy.
+- `mouse` - Włącza lub wyłącza przechwytywanie myszy w TUI (domyślnie `true`). Po wyłączeniu zachowane zostaje natywne zachowanie terminala przy zaznaczaniu i przewijaniu myszą.
+- `attention` - Konfiguruje powiadomienia pulpitu i dźwięki TUI. Domyślnie wyłączone.
+
+Użyj `OPENCODE_TUI_CONFIG`, aby załadować niestandardową ścieżkę konfiguracji TUI.
+
+### Attention
+
+Attention pozwala TUI powiadomić Cię, gdy OpenCode czeka na odpowiedź, wymaga zatwierdzenia uprawnienia, zgłasza błąd sesji albo informuje o zakończeniu sesji. Włącz tę funkcję za pomocą `attention.enabled`; wbudowane zdarzenia odtwarzają dźwięk, gdy wystąpią. Powiadomienia pulpitu są wysyłane tylko wtedy, gdy okno terminala nie jest aktywne, i nie są używane dla zdarzeń subagent.
+
+- `enabled` - Włącza wszystkie powiadomienia i dźwięki Attention. Domyślnie `false`.
+- `notifications` - Gdy Attention jest włączone, pozwala TUI wysyłać powiadomienia pulpitu przez terminal. Domyślnie `true`.
+- `sound` - Gdy Attention jest włączone, pozwala odtwarzać dźwięki powiadomień. Domyślnie `true`.
+- `volume` - Domyślna głośność dźwięków powiadomień od `0` do `1`. Domyślnie `0.4`.
+- `sound_pack` - ID sound pack do użycia. Domyślnie `opencode.default`.
+- `sounds` - Ustawia niestandardowe pliki dźwiękowe dla `default`, `question`, `permission`, `error`, `done` lub `subagent_done`. Ścieżki mogą być bezwzględne, być URL-ami `file://` albo być względne względem `tui.json`.
+
+---
+
+## Personalizacja
+
+Za pomocą palety poleceń (`ctrl+x h` lub `/help`) można dostosować różne aspekty widoku TUI. Te ustawienia są zachowywane po ponownym uruchomieniu.
+
+---
+
+#### Wyświetlanie nazwy użytkownika
+
+Włącz lub wyłącz wyświetlanie Twojej nazwy użytkownika w wiadomościach na czacie. Dostęp do tego poprzez:
+
+- Paleta poleceń: Wyszukaj „nazwę użytkownika” lub „ukryj nazwę użytkownika”
+- Ustawienie zostanie zapamiętane automatycznie i będzie pamiętane podczas sesji TUI

package/src/content/docs/pl/web.mdx

@@ -0,0 +1,142 @@
+---
+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.

package/src/content/docs/pl/windows-wsl.mdx

@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Uruchamiaj opencode na Windows z WSL dla najlepszych efektow.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+Chociaz opencode moze dzialac bezposrednio na Windows, dla najlepszych rezultatow zalecamy [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install). WSL zapewnia srodowisko Linuksa, ktore bardzo dobrze wspolpracuje z funkcjami opencode.
+
+:::tip[Dlaczego WSL?]
+WSL oferuje lepsza wydajnosc systemu plikow, pelna obsluge terminala i zgodnosc z narzedziami developerskimi, na ktorych opiera sie opencode.
+:::
+
+---
+
+## Konfiguracja
+
+<Steps>
+
+1. **Zainstaluj WSL**
+
+   Jesli jeszcze tego nie zrobiles, [zainstaluj WSL](https://learn.microsoft.com/en-us/windows/wsl/install) wedlug oficjalnego przewodnika Microsoft.
+
+2. **Zainstaluj opencode w WSL**
+
+   Po skonfigurowaniu WSL otworz terminal WSL i zainstaluj opencode jedna z [metod instalacji](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Korzystaj z opencode przez WSL**
+
+   Przejdz do katalogu projektu (pliki Windows sa dostepne przez `/mnt/c/`, `/mnt/d/` itd.) i uruchom opencode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## Aplikacja desktopowa + serwer WSL
+
+Jesli wolisz aplikacje desktopowa opencode, ale chcesz uruchamiac serwer w WSL:
+
+1. **Uruchom serwer w WSL** z `--hostname 0.0.0.0`, aby zezwolic na polaczenia zewnetrzne:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Polacz aplikacje desktopowa** z `http://localhost:4096`
+
+:::note
+Jesli `localhost` nie dziala w Twojej konfiguracji, polacz sie przez adres IP WSL (w WSL: `hostname -I`) i uzyj `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Przy uzyciu `--hostname 0.0.0.0` ustaw `OPENCODE_SERVER_PASSWORD`, aby zabezpieczyc serwer.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Klient web + WSL
+
+Dla najlepszej pracy w przegladarce na Windows:
+
+1. **Uruchamiaj `opencode web` w terminalu WSL**, a nie w PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Otworz w przegladarce Windows** pod adresem `http://localhost:<port>` (opencode wypisze URL)
+
+Uruchamianie `opencode web` z WSL zapewnia poprawny dostep do systemu plikow i integracje z terminalem, a nadal pozostaje dostepne z przegladarki Windows.
+
+---
+
+## Dostep do plikow Windows
+
+WSL moze uzyskac dostep do wszystkich plikow Windows przez katalog `/mnt/`:
+
+- Dysk `C:` → `/mnt/c/`
+- Dysk `D:` → `/mnt/d/`
+- I tak dalej...
+
+Przyklad:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Aby uzyskac najplynniejsza prace, rozwaz sklonowanie/skopiowanie repozytorium do systemu plikow WSL (np. do `~/code/`) i uruchamianie tam opencode.
+:::
+
+---
+
+## Wskazowki
+
+- Uruchamiaj opencode w WSL dla projektow zapisanych na dyskach Windows - dostep do plikow jest bezproblemowy
+- Uzywaj [rozszerzenia WSL dla VS Code](https://code.visualstudio.com/docs/remote/wsl) razem z opencode, aby miec zintegrowany workflow
+- Konfiguracja opencode i sesje sa przechowywane w srodowisku WSL pod `~/.local/share/opencode/`