@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,429 @@
+---
+title: TUI
+description: Arbeite mit OpenCode in der Terminal-Oberflaeche.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode bietet eine interaktive Terminaloberflaeche (TUI), um mit einem LLM an deinen Projekten zu arbeiten.
+
+Ohne weitere Argumente startet OpenCode die TUI im aktuellen Verzeichnis.
+
+```bash
+opencode
+```
+
+Oder du startest sie fuer ein bestimmtes Arbeitsverzeichnis.
+
+```bash
+opencode /path/to/project
+```
+
+In der TUI kannst du direkt mit einer Nachricht prompten.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## Datei-Referenzen
+
+Mit `@` kannst du Dateien in Nachrichten referenzieren.
+Dabei wird im aktuellen Verzeichnis eine unscharfe Dateisuche genutzt.
+
+:::tip
+Du kannst `@` in Nachrichten fuer Datei-Referenzen verwenden.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+Der Dateiinhalt wird automatisch zur Unterhaltung hinzugefuegt.
+
+---
+
+## Bash-Befehle
+
+Beginne eine Nachricht mit `!`, um einen Shell-Befehl auszufuehren.
+
+```bash frame="none"
+!ls -la
+```
+
+Die Ausgabe landet als Tool-Ergebnis in der Unterhaltung.
+
+---
+
+## Befehle
+
+In der OpenCode-TUI kannst du `/` plus Befehlsnamen eingeben, um Aktionen schnell auszufuehren.
+Zum Beispiel:
+
+```bash frame="none"
+/help
+```
+
+Viele Befehle haben auch Tastenkombinationen mit `ctrl+x` als Leader-Key.
+[Mehr dazu](/docs/keybinds).
+
+Hier sind alle verfuegbaren Slash-Commands:
+
+---
+
+### connect
+
+Fuegt einen Provider zu OpenCode hinzu. Erlaubt die Auswahl aus verfuegbaren Providern und das Hinzufuegen ihrer API-Keys.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compact
+
+Kompaktiert die aktuelle Session. _Alias_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**Keybind:** `ctrl+x c`
+
+---
+
+### details
+
+Schaltet Tool-Ausfuehrungsdetails um.
+
+```bash frame="none"
+/details
+```
+
+**Keybind:** `ctrl+x d`
+
+---
+
+### editor
+
+Oeffnet externen Editor zum Verfassen von Nachrichten. Nutzt den in der `EDITOR`-Umgebungsvariable gesetzten Editor. [Mehr dazu](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**Keybind:** `ctrl+x e`
+
+---
+
+### exit
+
+Beendet OpenCode. _Aliase_: `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**Keybind:** `ctrl+x q`
+
+---
+
+### export
+
+Exportiert die aktuelle Unterhaltung als Markdown und oeffnet sie in deinem Standard-Editor. Nutzt den in der `EDITOR`-Umgebungsvariable gesetzten Editor. [Mehr dazu](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**Keybind:** `ctrl+x x`
+
+---
+
+### help
+
+Zeigt den Hilfedialog.
+
+```bash frame="none"
+/help
+```
+
+**Keybind:** `ctrl+x h`
+
+---
+
+### init
+
+Erstellt oder aktualisiert die `AGENTS.md`-Datei. [Mehr dazu](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**Keybind:** `ctrl+x i`
+
+---
+
+### models
+
+Listet verfuegbare Modelle.
+
+```bash frame="none"
+/models
+```
+
+**Keybind:** `ctrl+x m`
+
+---
+
+### new
+
+Startet eine neue Session. _Alias_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**Keybind:** `ctrl+x n`
+
+---
+
+### redo
+
+Wiederholt eine zuvor rueckgaengig gemachte Nachricht. Nur verfuegbar nach Verwendung von `/undo`.
+
+:::tip
+Auch Dateiaenderungen werden wiederhergestellt.
+:::
+
+Intern nutzt dies Git, um die Dateiaenderungen zu verwalten. Dein Projekt muss also **ein Git-Repository sein**.
+
+```bash frame="none"
+/redo
+```
+
+**Keybind:** `ctrl+x r`
+
+---
+
+### sessions
+
+Listet Sessions und wechselt zwischen ihnen. _Aliase_: `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**Keybind:** `ctrl+x l`
+
+---
+
+### share
+
+Teilt die aktuelle Session. [Mehr dazu](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**Keybind:** `ctrl+x s`
+
+---
+
+### themes
+
+Listet verfuegbare Themes.
+
+```bash frame="none"
+/theme
+```
+
+**Keybind:** `ctrl+x t`
+
+---
+
+### thinking
+
+Schaltet die Sichtbarkeit von Thinking/Reasoning-Bloecken in der Unterhaltung um. Wenn aktiviert, kannst du den Denkprozess des Modells sehen (bei Modellen, die das unterstuetzen).
+
+:::note
+Dieser Befehl steuert nur, ob Thinking-Bloecke **angezeigt** werden - er aktiviert oder deaktiviert nicht die Reasoning-Faehigkeiten des Modells. Um die Reasoning-Faehigkeiten umzuschalten, nutze `ctrl+t`, um durch die Modell-Varianten zu wechseln.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### undo
+
+Macht die letzte Nachricht in der Unterhaltung rueckgaengig. Entfernt die letzte Benutzernachricht, alle folgenden Antworten und alle Dateiaenderungen.
+
+:::tip
+Auch durchgefuehrte Dateiaenderungen werden rueckgaengig gemacht.
+:::
+
+Intern nutzt dies Git, um die Dateiaenderungen zu verwalten. Dein Projekt muss also **ein Git-Repository sein**.
+
+```bash frame="none"
+/undo
+```
+
+**Keybind:** `ctrl+x u`
+
+---
+
+### unshare
+
+Hebt das Teilen der aktuellen Session auf. [Mehr dazu](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Editor-Einrichtung
+
+Sowohl `/editor` als auch `/export` nutzen den in deiner `EDITOR`-Umgebungsvariable spezifizierten 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"
+    ```
+
+    Um es dauerhaft zu machen, fuege dies zu deinem Shell-Profil hinzu;
+    `~/.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
+    ```
+
+    Um es dauerhaft zu machen, nutze **Systemeigenschaften** > **Umgebungsvariablen**.
+
+  </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"
+    ```
+
+    Um es dauerhaft zu machen, fuege dies zu deinem PowerShell-Profil hinzu.
+
+  </TabItem>
+</Tabs>
+
+Beliebte Editoren sind:
+
+- `code` - Visual Studio Code
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Neovim
+- `vim` - Vim
+- `nano` - Nano
+- `notepad` - Windows Notepad
+- `subl` - Sublime Text
+
+:::note
+Einige Editoren wie VS Code muessen mit dem `--wait`-Flag gestartet werden.
+:::
+
+Einige Editoren benoetigen Befehlszeilenargumente, um im blockierenden Modus zu laufen. Das `--wait`-Flag sorgt dafuer, dass der Editor-Prozess blockiert, bis er geschlossen wird.
+
+---
+
+## Konfiguration
+
+Du kannst das Verhalten der TUI ueber die Datei `tui.json` (oder `tui.jsonc`) anpassen.
+
+```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"
+    }
+  }
+}
+```
+
+Dies ist getrennt von `opencode.json`, welche das Server-/Runtime-Verhalten konfiguriert.
+
+`keybinds` wird mit den integrierten Standardwerten zusammengeführt, daher musst du nur die Tastenkombinationen konfigurieren, die du ändern möchtest.
+
+### Optionen
+
+- `theme` - Setzt dein UI-Theme. [Mehr dazu](/docs/themes).
+- `keybinds` - Passt Tastenkombinationen an. [Mehr dazu](/docs/keybinds).
+- `leader_timeout` - Steuert, wie lange OpenCode nach der leader key wartet. Standard ist `2000`.
+- `scroll_acceleration.enabled` - Aktiviert Scroll-Beschleunigung im macOS-Stil fuer weiches, natuerliches Scrollen. Wenn aktiviert, erhoeht sich die Scroll-Geschwindigkeit bei schnellen Gesten und bleibt praezise bei langsamen Bewegungen. **Diese Einstellung hat Vorrang vor `scroll_speed` und ueberschreibt es, wenn aktiviert.**
+- `scroll_speed` - Steuert, wie schnell die TUI scrollt (Minimum: `0.001`, unterstuetzt Dezimalwerte). Standard ist `3`. **Hinweis: Wird ignoriert, wenn `scroll_acceleration.enabled` auf `true` gesetzt ist.**
+- `diff_style` - Steuert die Diff-Darstellung. `"auto"` passt sich der Terminalbreite an, `"stacked"` zeigt immer ein einspaltiges Layout.
+- `mouse` - Aktiviert oder deaktiviert die Mauserfassung im TUI (Standard: `true`). Wenn deaktiviert, bleibt das native Mausauswahl- und Scrollverhalten des Terminals erhalten.
+- `attention` - Konfiguriert Desktop-Benachrichtigungen und Sounds des TUI. Standardmäßig deaktiviert.
+
+Verwende `OPENCODE_TUI_CONFIG`, um einen benutzerdefinierten TUI-Konfigurationspfad zu laden.
+
+### Attention
+
+Attention lässt das TUI dich benachrichtigen, wenn OpenCode auf eine Antwort wartet, eine Berechtigung bestätigt werden muss, ein Sitzungsfehler aufgetreten ist oder eine Sitzung abgeschlossen wurde. Aktiviere es mit `attention.enabled`; integrierte Ereignisse spielen beim Auftreten einen Sound ab. Desktop-Benachrichtigungen werden nur gesendet, wenn das Terminalfenster nicht fokussiert ist, und nicht für subagent-Ereignisse verwendet.
+
+- `enabled` - Aktiviert alle Benachrichtigungen und Sounds von Attention. Standard ist `false`.
+- `notifications` - Erlaubt dem TUI bei aktiviertem Attention, Desktop-Benachrichtigungen über das Terminal zu senden. Standard ist `true`.
+- `sound` - Erlaubt bei aktiviertem Attention das Abspielen von Hinweistönen. Standard ist `true`.
+- `volume` - Standardlautstärke der Hinweistöne von `0` bis `1`. Standard ist `0.4`.
+- `sound_pack` - Zu verwendende sound pack ID. Standard ist `opencode.default`.
+- `sounds` - Legt eigene Sounddateien für `default`, `question`, `permission`, `error`, `done` oder `subagent_done` fest. Pfade können absolut, `file://` URLs oder relativ zu `tui.json` sein.
+
+---
+
+## Anpassung
+
+Du kannst verschiedene Aspekte der TUI-Ansicht ueber die Befehlspalette (`ctrl+x h` oder `/help`) anpassen. Diese Einstellungen bleiben ueber Neustarts hinweg erhalten.
+
+---
+
+#### Benutzername-Anzeige
+
+Schaltet um, ob dein Benutzername in Chat-Nachrichten erscheint. Zugriff hierueber:
+
+- Befehlspalette: Suche nach "username" oder "hide username"
+- Die Einstellung wird automatisch gespeichert und bleibt ueber TUI-Sessions hinweg erhalten.

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

@@ -0,0 +1,142 @@
+---
+title: Web
+description: Verwenden Sie OpenCode in Ihrem Browser.
+---
+
+OpenCode kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet das gleiche leistungsstarke KI-Codierungserlebnis, ohne dass ein Terminal erforderlich ist.
+
+![OpenCode Web – Neue Sitzung](../../../assets/web/web-homepage-new-session.png)
+
+## Erste Schritte
+
+Starten Sie die Weboberfläche, indem Sie Folgendes ausführen:
+
+```bash
+opencode web
+```
+
+Dadurch wird ein lokaler Server auf `127.0.0.1` mit einem zufällig verfügbaren Port gestartet und OpenCode automatisch in Ihrem Standardbrowser geöffnet.
+
+:::caution
+Wenn `OPENCODE_SERVER_PASSWORD` nicht gesetzt ist, ist der Server ungesichert. Dies ist für den lokalen Gebrauch in Ordnung, sollte aber für den Netzwerkzugriff eingestellt werden.
+:::
+
+:::tip[Windows-Nutzer]
+Um die beste Erfahrung zu erzielen, führen Sie `opencode web` über [WSL](/docs/windows-wsl) und nicht über PowerShell aus. Dies gewährleistet den ordnungsgemäßen Zugriff auf das Dateisystem und die Terminalintegration.
+:::
+
+---
+
+## Konfiguration
+
+Sie können den Webserver mithilfe von Befehlszeilen-Flags oder in Ihrer [Konfigurationsdatei](/docs/config) konfigurieren.
+
+### Port
+
+Standardmäßig wählt OpenCode einen verfügbaren Port aus. Sie können einen Port angeben:
+
+```bash
+opencode web --port 4096
+```
+
+### Hostname
+
+Standardmäßig bindet der Server an `127.0.0.1` (nur localhost). So machen Sie OpenCode in Ihrem Netzwerk zugänglich:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+Bei Verwendung von `0.0.0.0` zeigt OpenCode sowohl lokale als auch Netzwerkadressen an:
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### mDNS-Erkennung
+
+Aktivieren Sie mDNS, um Ihren Server im lokalen Netzwerk erkennbar zu machen:
+
+```bash
+opencode web --mdns
+```
+
+Dadurch wird der Hostname automatisch auf `0.0.0.0` gesetzt und der Server als `opencode.local` angekündigt.
+
+Sie können den mDNS-Domänennamen anpassen, um mehrere Instanzen im selben Netzwerk auszuführen:
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+So erlauben Sie zusätzliche Domänen für CORS (nützlich für benutzerdefinierte Frontends):
+
+```bash
+opencode web --cors https://example.com
+```
+
+### Authentifizierung
+
+Um den Zugriff zu schützen, legen Sie mithilfe der Umgebungsvariablen `OPENCODE_SERVER_PASSWORD` ein Passwort fest:
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+Der Benutzername ist standardmäßig `opencode`, kann aber mit `OPENCODE_SERVER_USERNAME` geändert werden.
+
+---
+
+## Verwenden der Weboberfläche
+
+Nach dem Start bietet die Weboberfläche Zugriff auf Ihre OpenCode-Sitzungen.
+
+### Sitzungen
+
+Zeigen Sie Ihre Sitzungen auf der Startseite an und verwalten Sie sie. Sie können aktive Sitzungen sehen und neue starten.
+
+![OpenCode Web – Aktive Sitzung](../../../assets/web/web-homepage-active-session.png)
+
+### Serverstatus
+
+Klicken Sie auf „Server anzeigen“, um verbundene Server und deren Status anzuzeigen.
+
+![OpenCode Web – Siehe Server](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## Anschließen eines Terminals
+
+Sie können eine Terminal-TUI an einen laufenden Webserver anschließen:
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode attach http://localhost:4096
+```
+
+Dadurch können Sie sowohl die Weboberfläche als auch das Terminal gleichzeitig verwenden und dieselben Sitzungen und denselben Status teilen.
+
+---
+
+## Konfigurationsdatei
+
+Sie können Servereinstellungen auch in Ihrer `opencode.json`-Konfigurationsdatei konfigurieren:
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+Befehlszeilenflags haben Vorrang vor Konfigurationsdateieinstellungen.

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

@@ -0,0 +1,115 @@
+---
+title: Windows (WSL)
+description: Nutze OpenCode unter Windows am besten mit WSL.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+OpenCode laeuft zwar direkt unter Windows, die beste Erfahrung bekommst du aber mit [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install).
+WSL bietet eine Linux-Umgebung, die mit den OpenCode-Features nahtlos funktioniert.
+
+:::tip[Warum WSL?]
+WSL bietet bessere Dateisystem-Performance, vollstaendige Terminal-Unterstuetzung und hohe Kompatibilitaet mit den Entwicklungswerkzeugen, die OpenCode nutzt.
+:::
+
+---
+
+## Einrichtung
+
+<Steps>
+
+1. **Install WSL**
+
+   Falls noch nicht geschehen, installiere [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) mit der offiziellen Microsoft-Anleitung.
+
+2. **Install OpenCode in WSL**
+
+   Wenn WSL eingerichtet ist, oeffne dein WSL-Terminal und installiere OpenCode mit einer der [Installationsmethoden](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **OpenCode über WSL verwenden**
+
+   Wechsle in dein Projektverzeichnis (Windows-Dateien erreichst du ueber `/mnt/c/`, `/mnt/d/` usw.) und starte OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## Desktop-App + WSL-Server
+
+Wenn du die OpenCode-Desktop-App nutzen willst, den Server aber in WSL betreiben moechtest:
+
+1. **Starte den Server in WSL** mit `--hostname 0.0.0.0`, damit externe Verbindungen moeglich sind:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Verbinde die Desktop-App** mit `http://localhost:4096`
+
+:::note
+Wenn `localhost` in deiner Umgebung nicht funktioniert, nutze stattdessen die WSL-IP-Adresse (in WSL: `hostname -I`) und verbinde dich mit `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Wenn du `--hostname 0.0.0.0` verwendest, setze `OPENCODE_SERVER_PASSWORD`, um den Server zu schuetzen.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Web-Client + WSL
+
+Fuer die beste Web-Erfahrung unter Windows:
+
+1. **Fuehre `opencode web` im WSL-Terminal aus**, nicht in PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Rufe die URL im Windows-Browser auf** unter `http://localhost:<port>` (OpenCode zeigt die URL an)
+
+Wenn du `opencode web` aus WSL startest, bleiben Dateizugriff und Terminal-Integration sauber.
+Gleichzeitig ist die Weboberflaeche weiterhin im Windows-Browser erreichbar.
+
+---
+
+## Zugriff auf Windows-Dateien
+
+WSL kann ueber das Verzeichnis `/mnt/` auf alle Windows-Dateien zugreifen:
+
+- Laufwerk `C:` -> `/mnt/c/`
+- Laufwerk `D:` -> `/mnt/d/`
+- usw.
+
+Beispiel:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Fuer die beste Performance kannst du dein Repo direkt in das WSL-Dateisystem klonen/kopieren (z. B. nach `~/code/`) und OpenCode dort starten.
+:::
+
+---
+
+## Tipps
+
+- Lass OpenCode in WSL laufen, auch wenn das Projekt auf einem Windows-Laufwerk liegt
+- Nutze die [WSL-Extension](https://code.visualstudio.com/docs/remote/wsl) von VS Code fuer einen integrierten Workflow
+- OpenCode-Konfiguration und Sitzungen liegen in WSL unter `~/.local/share/opencode/`