@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,352 @@
+---
+title: Tools
+description: Verwalte, welche Tools ein LLM nutzen darf.
+---
+
+Tools erlauben dem LLM Aktionen in deiner Codebasis.
+OpenCode bringt eingebaute Tools mit und laesst sich ueber [Custom Tools](/docs/custom-tools) oder [MCP-Server](/docs/mcp-servers) erweitern.
+
+Standardmaessig sind alle Tools **aktiviert** und brauchen keine Freigabe.
+Das Verhalten steuerst du ueber [Berechtigungen](/docs/permissions).
+
+---
+
+## Konfiguration
+
+Nutze das Feld `permission`, um Tool-Verhalten zu steuern.
+Pro Tool kannst du erlauben, verbieten oder eine Rueckfrage verlangen.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "deny",
+    "bash": "ask",
+    "webfetch": "allow"
+  }
+}
+```
+
+Mit Wildcards kannst du mehrere Tools auf einmal steuern.
+Zum Beispiel, um fuer alle Tools eines MCP-Servers eine Freigabe zu verlangen:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "mymcp_*": "ask"
+  }
+}
+```
+
+[Mehr dazu](/docs/permissions), wie du Berechtigungen konfigurierst.
+
+---
+
+## Eingebaut
+
+Hier sind alle in OpenCode verfuegbaren eingebauten Tools.
+
+---
+
+### bash
+
+Fuehrt Shell-Befehle in deiner Projektumgebung aus.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": "allow"
+  }
+}
+```
+
+Damit kann das LLM Terminal-Befehle wie `npm install`, `git status` oder andere Shell-Kommandos ausfuehren.
+
+---
+
+### edit
+
+Bearbeitet bestehende Dateien ueber exakte String-Ersetzungen.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Dieses Tool fuehrt praezise Aenderungen per exakter Textsuche aus.
+Es ist der zentrale Weg, wie das LLM Code aendert.
+
+---
+
+### write
+
+Erstellt neue Dateien oder ueberschreibt bestehende Dateien.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Damit erlaubst du dem LLM, neue Dateien anzulegen.
+Bestehende Dateien werden dabei ueberschrieben.
+
+:::note
+Das Tool `write` wird ueber die Berechtigung `edit` gesteuert.
+`edit` gilt fuer alle Datei-Aenderungen (`edit`, `write`, `patch`).
+:::
+
+---
+
+### read
+
+Liest Dateiinhalte aus deiner Codebasis.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "read": "allow"
+  }
+}
+```
+
+Dieses Tool liest Dateien und gibt deren Inhalt zurueck. Es unterstuetzt das Lesen spezifischer Zeilenbereiche bei grossen Dateien.
+
+---
+
+### grep
+
+Durchsucht Dateiinhalte mit regulaeren Ausdruecken.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "grep": "allow"
+  }
+}
+```
+
+Schnelle Inhaltssuche in deiner Codebasis. Unterstuetzt volle Regex-Syntax und Filterung nach Dateimustern.
+
+---
+
+### glob
+
+Findet Dateien per Musterabgleich.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "glob": "allow"
+  }
+}
+```
+
+Sucht nach Dateien mit Glob-Mustern wie `**/*.js` oder `src/**/*.ts`. Gibt passende Dateipfade sortiert nach Aenderungsdatum zurueck.
+
+---
+
+### lsp (experimentell)
+
+Interagiere mit deinen konfigurierten LSP-Servern fuer Code-Intelligence-Features wie Definitionen, Referenzen, Hover-Infos und Call-Hierarchien.
+
+:::note
+Dieses Tool ist nur verfuegbar, wenn `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (oder `OPENCODE_EXPERIMENTAL=true`) gesetzt ist.
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "lsp": "allow"
+  }
+}
+```
+
+Unterstuetzte Operationen sind `goToDefinition`, `findReferences`, `hover`, `documentSymbol`, `workspaceSymbol`, `goToImplementation`, `prepareCallHierarchy`, `incomingCalls` und `outgoingCalls`.
+
+Um verfuegbare LSP-Server fuer dein Projekt zu konfigurieren, siehe [LSP-Server](/docs/lsp).
+
+---
+
+### patch
+
+Wendet Patches auf Dateien an.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Dieses Tool wendet Patch-Dateien auf deine Codebasis an. Nuetzlich fuer Diffs und Patches aus verschiedenen Quellen.
+
+:::note
+Das Tool `patch` wird ueber die Berechtigung `edit` gesteuert, welche alle Datei-Aenderungen abdeckt (`edit`, `write`, `patch`).
+:::
+
+---
+
+### skill
+
+Laedt einen [Skill](/docs/skills) (eine `SKILL.md`-Datei) und gibt dessen Inhalt in der Unterhaltung zurueck.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "skill": "allow"
+  }
+}
+```
+
+---
+
+### todowrite
+
+Verwaltet Todo-Listen waehrend Coding-Sessions.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "todowrite": "allow"
+  }
+}
+```
+
+Erstellt und aktualisiert Aufgabenlisten, um den Fortschritt bei komplexen Operationen zu verfolgen. Das LLM nutzt dies, um mehrstufige Aufgaben zu organisieren.
+
+:::note
+Dieses Tool ist fuer Sub-Agenten standardmaessig deaktiviert, kann aber manuell aktiviert werden. [Mehr dazu](/docs/agents/#permissions)
+:::
+
+---
+
+### webfetch
+
+Ruft Webinhalte ab.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "webfetch": "allow"
+  }
+}
+```
+
+Erlaubt dem LLM, Webseiten abzurufen und zu lesen. Nuetzlich zum Nachschlagen von Dokumentation oder fuer Online-Recherche.
+
+---
+
+### websearch
+
+Durchsucht das Web nach Informationen.
+
+:::note
+Dieses Tool ist nur verfuegbar, wenn der OpenCode-Provider genutzt wird oder die Umgebungsvariable `OPENCODE_ENABLE_EXA` auf einen 'truthy' Wert (z. B. `true` oder `1`) gesetzt ist.
+
+Zum Aktivieren beim Start von OpenCode:
+
+```bash
+OPENCODE_ENABLE_EXA=1 opencode
+```
+
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "websearch": "allow"
+  }
+}
+```
+
+Fuehrt Websuchen mit Exa AI durch, um relevante Informationen online zu finden. Nuetzlich fuer Recherche, aktuelle Ereignisse oder Informationen jenseits des Trainingsdatums.
+
+Kein API-Key erforderlich — das Tool verbindet sich direkt mit dem gehosteten MCP-Service von Exa AI ohne Authentifizierung.
+
+:::tip
+Nutze `websearch` zum Finden von Informationen (Discovery) und `webfetch` zum Abrufen von Inhalten einer spezifischen URL (Retrieval).
+:::
+
+---
+
+### question
+
+Stellt dem Benutzer waehrend der Ausfuehrung Fragen.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "question": "allow"
+  }
+}
+```
+
+Dieses Tool erlaubt dem LLM, dem Benutzer waehrend einer Aufgabe Fragen zu stellen. Nuetzlich fuer:
+
+- Sammeln von Benutzerpraeferenzen oder Anforderungen
+- Klaerung mehrdeutiger Anweisungen
+- Entscheidungen bei Implementierungsoptionen einholen
+- Auswahlmoeglichkeiten fuer das weitere Vorgehen anbieten
+
+Jede Frage enthaelt eine Ueberschrift, den Fragetext und eine Liste von Optionen. Benutzer koennen aus den Optionen waehlen oder eine eigene Antwort eingeben. Bei mehreren Fragen koennen Benutzer zwischen ihnen navigieren, bevor sie alle Antworten absenden.
+
+---
+
+## Benutzerdefinierte Tools
+
+Mit Custom Tools definierst du eigene Funktionen, die das LLM aufrufen kann.
+Sie werden in der Konfigurationsdatei definiert und koennen beliebigen Code ausfuehren.
+
+[Mehr dazu](/docs/custom-tools), wie du Custom Tools erstellst.
+
+---
+
+## MCP-Server
+
+MCP-Server (Model Context Protocol) binden externe Tools und Dienste ein.
+Dazu gehoeren Datenbanken, API-Integrationen und Drittanbieter-Services.
+
+[Mehr dazu](/docs/mcp-servers), wie du MCP-Server konfigurierst.
+
+---
+
+## Interna
+
+Intern verwenden Tools wie `grep` und `glob` [ripgrep](https://github.com/BurntSushi/ripgrep).
+Standardmaessig beachtet ripgrep `.gitignore`, daher werden dort aufgefuehrte Dateien und Ordner nicht durchsucht.
+
+---
+
+### Ignorier-Muster
+
+Wenn du normalerweise ignorierte Dateien einschliessen willst, lege im Projekt-Root eine `.ignore`-Datei an.
+Dort kannst du Pfade explizit erlauben.
+
+```text title=".ignore"
+!node_modules/
+!dist/
+!build/
+```
+
+Dieses Beispiel erlaubt ripgrep, in `node_modules/`, `dist/` und `build/` zu suchen, auch wenn sie in `.gitignore` stehen.

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

@@ -0,0 +1,300 @@
+---
+title: Fehlerbehebung
+description: Haeufige Probleme und schnelle Loesungen.
+---
+
+Wenn OpenCode Probleme macht, starte mit Logs und lokal gespeicherten Daten auf der Festplatte.
+
+---
+
+## Logs
+
+Logdateien werden hier gespeichert:
+
+- **macOS/Linux**: `~/.local/share/opencode/log/`
+- **Windows**: Druecke `WIN+R` und fuege ein: `%USERPROFILE%\.local\share\opencode\log`
+
+Dateinamen enthalten Zeitstempel (z. B. `2025-01-09T123456.log`) und es bleiben die letzten 10 Logs erhalten.
+
+Mit `--log-level` bekommst du detailliertere Diagnoseinfos, z. B. `opencode --log-level DEBUG`.
+
+---
+
+## Speicher
+
+opencode speichert Sitzungs- und App-Daten auf der Festplatte unter:
+
+- **macOS/Linux**: `~/.local/share/opencode/`
+- **Windows**: Druecke `WIN+R` und fuege ein: `%USERPROFILE%\.local\share\opencode`
+
+Dieses Verzeichnis enthaelt:
+
+- `auth.json` - Authentifizierungsdaten wie API-Keys und OAuth-Tokens
+- `log/` - Anwendungslogs
+- `project/` - Projektspezifische Daten wie Sitzungen und Nachrichten
+  - In Git-Repositories unter `./<project-slug>/storage/`
+  - Ohne Git unter `./global/storage/`
+
+---
+
+## Desktop-App
+
+OpenCode Desktop startet im Hintergrund einen lokalen OpenCode-Server (`opencode-cli`-Sidecar).
+Viele Probleme kommen von fehlerhaften Plugins, kaputtem Cache oder falschen Server-Einstellungen.
+
+### Schnellchecks
+
+- App komplett beenden und neu starten
+- Bei Fehlerbildschirm **Restart** klicken und Details kopieren
+- Nur macOS: `OpenCode`-Menue -> **Reload Webview** (hilft bei leerer/eingefrorener UI)
+
+---
+
+### Plugins deaktivieren
+
+Wenn die Desktop-App beim Start abstuerzt, haengt oder sich seltsam verhaelt, deaktiviere zunaechst Plugins.
+
+#### Globale Konfiguration prüfen
+
+Oeffne deine globale Konfigurationsdatei und suche nach dem `plugin`-Schluessel.
+
+- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (oder `~/.config/opencode/opencode.json`)
+- **macOS/Linux** (aeltere Installationen): `~/.local/share/opencode/opencode.jsonc`
+- **Windows**: Druecke `WIN+R` und fuege ein: `%USERPROFILE%\.config\opencode\opencode.jsonc`
+
+Wenn du Plugins konfiguriert hast, deaktiviere sie voruebergehend, indem du den Schluessel entfernst oder auf ein leeres Array setzt:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [],
+}
+```
+
+#### Plugin-Verzeichnisse prüfen
+
+OpenCode kann auch lokale Plugins von der Festplatte laden. Verschiebe diese voruebergehend (oder benenne den Ordner um) und starte die Desktop-App neu:
+
+- **Globale Plugins**
+  - **macOS/Linux**: `~/.config/opencode/plugins/`
+  - **Windows**: Druecke `WIN+R` und fuege ein: `%USERPROFILE%\.config\opencode\plugins`
+- **Projekt-Plugins** (nur bei projektspezifischer Konfig)
+  - `<your-project>/.opencode/plugins/`
+
+Wenn die App wieder funktioniert, aktiviere Plugins nacheinander, um den Verursacher zu finden.
+
+---
+
+### Cache leeren
+
+Wenn das Deaktivieren von Plugins nicht hilft (oder eine Plugin-Installation haengt), leere den Cache, damit OpenCode ihn neu aufbauen kann.
+
+1. Beende OpenCode Desktop komplett.
+2. Loesche das Cache-Verzeichnis:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> einfuegen: `~/.cache/opencode`
+- **Linux**: loesche `~/.cache/opencode` (oder fuehre aus: `rm -rf ~/.cache/opencode`)
+- **Windows**: Druecke `WIN+R` und fuege ein: `%USERPROFILE%\.cache\opencode`
+
+3. Starte OpenCode Desktop neu.
+
+---
+
+### Server-Verbindungsprobleme beheben
+
+OpenCode Desktop kann entweder einen eigenen lokalen Server starten (Standard) oder sich mit einer konfigurierten Server-URL verbinden.
+
+Wenn du einen **"Connection Failed"**-Dialog siehst (oder die App beim Splash-Screen haengen bleibt), pruefe auf eine benutzerdefinierte Server-URL.
+
+#### Desktop-Standard-Server-URL löschen
+
+Klicke im Startbildschirm auf den Servernamen (mit dem Statuspunkt), um die Serverauswahl zu oeffnen. Klicke im Bereich **Default server** auf **Clear**.
+
+#### `server.port` / `server.hostname` aus Konfiguration entfernen
+
+Wenn deine `opencode.json(c)` einen `server`-Abschnitt enthaelt, entferne ihn voruebergehend und starte die Desktop-App neu.
+
+#### Umgebungsvariablen prüfen
+
+Wenn du `OPENCODE_PORT` in deiner Umgebung gesetzt hast, versucht die Desktop-App diesen Port fuer den lokalen Server zu nutzen.
+
+- Setze `OPENCODE_PORT` zurueck (oder waehle einen freien Port) und starte neu.
+
+---
+
+### Linux: Wayland / X11-Probleme
+
+Unter Linux koennen manche Wayland-Setups leere Fenster oder Compositor-Fehler verursachen.
+
+- Wenn du Wayland nutzt und die App leer ist/abstuerzt, versuche den Start mit `OC_ALLOW_WAYLAND=1`.
+- Wenn das es verschlimmert, entferne es und versuche den Start in einer X11-Session.
+
+---
+
+### Windows: WebView2-Laufzeit
+
+Unter Windows benoetigt OpenCode Desktop die Microsoft Edge **WebView2 Runtime**. Wenn die App ein leeres Fenster zeigt oder nicht startet, installiere/aktualisiere WebView2 und versuche es erneut.
+
+---
+
+### Windows: Allgemeine Performance-Probleme
+
+Wenn du langsame Performance, Dateizugriffsprobleme oder Terminal-Probleme unter Windows hast, versuche [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL bietet eine Linux-Umgebung, die nahtloser mit OpenCode-Features funktioniert.
+
+---
+
+### Benachrichtigungen werden nicht angezeigt
+
+OpenCode Desktop zeigt Systembenachrichtigungen nur wenn:
+
+- Benachrichtigungen fuer OpenCode in den OS-Einstellungen aktiviert sind, und
+- das App-Fenster nicht fokussiert ist.
+
+---
+
+### Desktop-App-Speicher zurücksetzen (letzter Ausweg)
+
+Wenn die App nicht startet und du Einstellungen nicht in der UI loeschen kannst, setze den gespeicherten Zustand der Desktop-App zurueck.
+
+1. Beende OpenCode Desktop.
+2. Finde und loesche diese Dateien (im App-Data-Verzeichnis von OpenCode Desktop):
+
+- `opencode.settings.dat` (desktop default server URL)
+- `opencode.global.dat` und `opencode.workspace.*.dat` (UI state like recent servers/projects)
+
+So findest du das Verzeichnis schnell:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (dann suche nach den Dateinamen oben)
+- **Linux**: suche unter `~/.local/share` nach den Dateinamen oben
+- **Windows**: Druecke `WIN+R` -> `%APPDATA%` (dann suche nach den Dateinamen oben)
+
+---
+
+## Hilfe bekommen
+
+Wenn du Probleme mit OpenCode hast:
+
+1. **Probleme auf GitHub melden**
+
+   Bugs und Feature-Wuensche meldest du am besten im GitHub-Repository:
+
+   [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues)
+
+   Suche vor dem Erstellen nach bestehenden Issues, damit Duplikate vermieden werden.
+
+2. **Unserem Discord beitreten**
+
+   Fuer schnelle Hilfe und Austausch in der Community:
+
+   [**opencode.ai/discord**](https://opencode.ai/discord)
+
+---
+
+## Haeufige Probleme
+
+Hier sind typische Fehlerbilder und wie du sie loest.
+
+---
+
+### OpenCode startet nicht
+
+1. Pruefe die Logs auf Fehlermeldungen
+2. Versuche den Start mit `--print-logs`, um Ausgaben im Terminal zu sehen
+3. Stelle sicher, dass du die neueste Version hast: `opencode upgrade`
+
+---
+
+### Authentifizierungsprobleme
+
+1. Versuche erneute Authentifizierung mit `/connect` in der TUI
+2. Pruefe, ob deine API-Keys gueltig sind
+3. Stelle sicher, dass dein Netzwerk Verbindungen zur Provider-API erlaubt
+
+---
+
+### Modell nicht verfügbar
+
+1. Pruefe, ob du dich beim Provider authentifiziert hast
+2. Verifiziere, dass der Modellname in deiner Config korrekt ist
+3. Manche Modelle erfordern speziellen Zugriff oder Abonnements
+
+Wenn du `ProviderModelNotFoundError` erhaeltst, referenzierst du ein Modell wahrscheinlich falsch.
+Modelle sollten so referenziert werden: `<providerId>/<modelId>`
+
+Beispiele:
+
+- `openai/gpt-4.1`
+- `openrouter/google/gemini-2.5-flash`
+- `opencode/kimi-k2`
+
+Um zu sehen, auf welche Modelle du Zugriff hast, fuehre `opencode models` aus.
+
+---
+
+### ProviderInitError
+
+Wenn du einen ProviderInitError erhaeltst, hast du wahrscheinlich eine ungueltige oder korrupte Konfiguration.
+
+Zur Loesung:
+
+1. Pruefe zuerst, ob dein Provider korrekt eingerichtet ist, gemaess dem [Provider-Guide](/docs/providers)
+2. Wenn das Problem besteht, versuche deine gespeicherte Konfiguration zu loeschen:
+
+   ```bash
+   rm -rf ~/.local/share/opencode
+   ```
+
+   Unter Windows druecke `WIN+R` und loesche: `%USERPROFILE%\.local\share\opencode`
+
+3. Authentifiziere dich erneut beim Provider mit dem `/connect`-Befehl in der TUI.
+
+---
+
+### AI_APICallError und Provider-Paket-Probleme
+
+Wenn du API-Call-Fehler erhaeltst, kann das an veralteten Provider-Paketen liegen. opencode installiert Provider-Pakete (OpenAI, Anthropic, Google, etc.) dynamisch bei Bedarf und cached sie lokal.
+
+Um Provider-Paket-Probleme zu loesen:
+
+1. Leere den Provider-Paket-Cache:
+
+   ```bash
+   rm -rf ~/.cache/opencode
+   ```
+
+   Unter Windows druecke `WIN+R` und loesche: `%USERPROFILE%\.cache\opencode`
+
+2. Starte opencode neu, um die neuesten Provider-Pakete zu installieren
+
+Dies zwingt opencode, die neuesten Versionen der Provider-Pakete herunterzuladen, was oft Kompatibilitaetsprobleme mit Modellparametern und API-Aenderungen loest.
+
+---
+
+### Copy/Paste funktioniert nicht unter Linux
+
+Linux-Nutzer muessen eines der folgenden Clipboard-Utilities installiert haben, damit Copy/Paste funktioniert:
+
+**Fuer X11-Systeme:**
+
+```bash
+apt install -y xclip
+# or
+apt install -y xsel
+```
+
+**Fuer Wayland-Systeme:**
+
+```bash
+apt install -y wl-clipboard
+```
+
+**Fuer Headless-Umgebungen:**
+
+```bash
+apt install -y xvfb
+# and run:
+Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
+export DISPLAY=:99.0
+```
+
+opencode erkennt, ob du Wayland nutzt und bevorzugt `wl-clipboard`, sonst versucht es `xclip` und `xsel` (in dieser Reihenfolge).