cc-viewer 1.6.182 → 1.6.183

package/concepts/de/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Definition
+Durchsucht Dateiinhalte mit der ripgrep-Engine. Bietet vollständige Unterstützung für reguläre Ausdrücke, Dateityp-Filter und drei Ausgabemodi, sodass Sie Präzision gegen Kompaktheit abwägen können.
 
-Leistungsstarkes Inhaltssuchtool basierend auf ripgrep. Unterstützt reguläre Ausdrücke, Dateitypfilterung und mehrere Ausgabemodi.
+## Wann verwenden
+
+- Auffinden jeder Aufrufstelle einer Funktion oder jeder Referenz auf einen Bezeichner
+- Prüfen, ob ein String oder eine Fehlermeldung irgendwo im Codebase vorkommt
+- Zählen von Musterauftreten, um den Impact vor einem Refactoring einzuschätzen
+- Einschränken einer Suche auf einen Dateityp (`type: "ts"`) oder Glob (`glob: "**/*.tsx"`)
+- Zeilenübergreifende Treffer wie mehrzeilige Strukturdefinitionen oder JSX-Blöcke mit `multiline: true` herausziehen
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `pattern` | string | Ja | Reguläres Ausdruckssuchmuster |
-| `path` | string | Nein | Suchpfad (Datei oder Verzeichnis), Standard ist das aktuelle Arbeitsverzeichnis |
-| `glob` | string | Nein | Dateinamenfilter (z.B. `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Nein | Dateitypfilter (z.B. `js`, `py`, `rust`), effizienter als glob |
-| `output_mode` | enum | Nein | Ausgabemodus: `files_with_matches` (Standard), `content`, `count` |
-| `-i` | boolean | Nein | Groß-/Kleinschreibung ignorieren |
-| `-n` | boolean | Nein | Zeilennummern anzeigen (nur content-Modus), Standard true |
-| `-A` | number | Nein | Anzahl der Zeilen nach dem Treffer |
-| `-B` | number | Nein | Anzahl der Zeilen vor dem Treffer |
-| `-C` / `context` | number | Nein | Anzahl der Zeilen vor und nach dem Treffer |
-| `head_limit` | number | Nein | Ausgabeeinträge begrenzen, Standard 0 (unbegrenzt) |
-| `offset` | number | Nein | Erste N Ergebnisse überspringen |
-| `multiline` | boolean | Nein | Mehrzeiligen Abgleichmodus aktivieren, Standard false |
-
-## Anwendungsfälle
-
-**Geeignet für:**
-- Bestimmte Zeichenketten oder Muster in der Codebasis suchen
-- Verwendungsstellen von Funktionen/Variablen finden
-- Suchergebnisse nach Dateityp filtern
-- Trefferanzahl zählen
-
-**Nicht geeignet für:**
-- Dateien nach Dateinamen suchen – dafür Glob verwenden
-- Offene Erkundung mit mehreren Suchrunden – dafür Task (Explore-Typ) verwenden
+- `pattern` (string, erforderlich): Der reguläre Ausdruck für die Suche. Nutzt die ripgrep-Syntax, literale geschweifte Klammern müssen escaped werden (zum Beispiel `interface\{\}`, um `interface{}` zu finden).
+- `path` (string, optional): Datei oder Verzeichnis zum Durchsuchen. Standard ist das aktuelle Arbeitsverzeichnis.
+- `glob` (string, optional): Dateinamensfilter wie `*.js` oder `*.{ts,tsx}`.
+- `type` (string, optional): Dateityp-Kürzel wie `js`, `py`, `rust`, `go`. Effizienter als `glob` für Standardsprachen.
+- `output_mode` (enum, optional): `files_with_matches` (Standard, gibt nur Pfade zurück), `content` (gibt übereinstimmende Zeilen zurück) oder `count` (gibt Trefferzahlen zurück).
+- `-i` (boolean, optional): Groß-/Kleinschreibung ignorierende Suche.
+- `-n` (boolean, optional): Zeilennummern in `content`-Modus einbeziehen. Standard ist `true`.
+- `-A` (number, optional): Anzahl der Kontextzeilen nach jedem Treffer (erfordert `content`-Modus).
+- `-B` (number, optional): Anzahl der Kontextzeilen vor jedem Treffer (erfordert `content`-Modus).
+- `-C` / `context` (number, optional): Kontextzeilen auf beiden Seiten jedes Treffers.
+- `multiline` (boolean, optional): Erlaubt Mustern, Zeilenumbrüche zu überspannen (`.` matcht `\n`). Standard ist `false`.
+- `head_limit` (number, optional): Begrenzung der zurückgegebenen Zeilen, Dateipfade oder Zählwerte. Standard ist 250; `0` für unbegrenzt (sparsam verwenden).
+- `offset` (number, optional): Überspringt die ersten N Ergebnisse, bevor `head_limit` angewendet wird. Standard ist `0`.
+
+## Beispiele
+
+### Beispiel 1: Alle Aufrufstellen einer Funktion finden
+`pattern: "registerHandler\\("`, `output_mode: "content"` und `-C: 2` setzen, um die umgebenden Zeilen jedes Aufrufs zu sehen.
+
+### Beispiel 2: Treffer über einen Typ hinweg zählen
+`pattern: "TODO"`, `type: "py"` und `output_mode: "count"` setzen, um TODO-Summen pro Datei in Python-Quellen zu sehen.
+
+### Beispiel 3: Mehrzeiliger Struct-Match
+`pattern: "struct Config \\{[\\s\\S]*?version"` mit `multiline: true` verwenden, um ein Feld zu erfassen, das mehrere Zeilen tief in einem Go-Struct deklariert ist.
 
 ## Hinweise
 
-- Verwendet ripgrep-Syntax (nicht grep), geschweifte Klammern und andere Sonderzeichen müssen escaped werden
-- `files_with_matches`-Modus gibt nur Dateipfade zurück, am effizientesten
-- `content`-Modus gibt übereinstimmende Zeileninhalte zurück, unterstützt Kontextzeilen
-- Mehrzeiliger Abgleich erfordert `multiline: true`
-- Immer das Grep-Tool gegenüber `grep` oder `rg` in Bash bevorzugen
-
-## Originaltext
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Bevorzugen Sie stets `Grep` gegenüber dem Ausführen von `grep` oder `rg` über `Bash`; das Tool ist auf korrekte Berechtigungen und strukturierte Ausgabe optimiert.
+- Der Standard-Ausgabemodus ist `files_with_matches`, der günstigste. Wechseln Sie nur zu `content`, wenn Sie die Zeilen selbst sehen müssen.
+- Kontext-Flags (`-A`, `-B`, `-C`) werden ignoriert, sofern `output_mode` nicht `content` ist.
+- Große Ergebnismengen verbrauchen Kontext-Token. Nutzen Sie `head_limit`, `offset` oder strengere `glob`/`type`-Filter, um fokussiert zu bleiben.
+- Für die Dateinamensfindung verwenden Sie stattdessen `Glob`; für offene Untersuchungen über viele Runden eine `Agent` mit dem Explore-Agenten entsenden.

package/concepts/de/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Startet einen Hintergrundmonitor, der Ereignisse von einem lang laufenden Skript streamt. Jede Zeile der Standardausgabe wird zu einer Benachrichtigung — weiterarbeiten, während Ereignisse im Chat eintreffen.
+
+## Wann verwenden
+
+- Verfolgen von Fehlern, Warnungen oder Absturzsignaturen in einer Logdatei während einer laufenden Bereitstellung
+- Abfragen einer Remote-API, eines PR oder einer CI-Pipeline alle 30 Sekunden auf neue Statusereignisse
+- Überwachen von Änderungen in einem Dateisystemverzeichnis oder in der Build-Ausgabe in Echtzeit
+- Warten auf eine bestimmte Bedingung über viele Iterationen hinweg (z. B. ein Trainingsschritt-Meilenstein oder das Leeren einer Warteschlange)
+- **Nicht** für einfaches "Warten bis fertig" — dafür `Bash` mit `run_in_background` verwenden; es sendet eine Fertigstellungsbenachrichtigung, wenn der Prozess beendet wird
+
+## Parameter
+
+- `command` (Zeichenkette, erforderlich): Der auszuführende Shell-Befehl oder das Skript. Jede in die Standardausgabe geschriebene Zeile wird zu einem eigenständigen Benachrichtigungsereignis. Der Monitor endet, wenn der Prozess beendet wird.
+- `description` (Zeichenkette, erforderlich): Eine kurze, lesbare Bezeichnung, die in jeder Benachrichtigung angezeigt wird. Konkret sein — "Fehler in deploy.log" ist besser als "Logs überwachen". Dieses Label identifiziert, welcher Monitor ausgelöst hat.
+- `timeout_ms` (Zahl, Standard `300000`, max `3600000`): Abbruchfrist in Millisekunden. Nach dieser Dauer wird der Prozess beendet. Wird ignoriert, wenn `persistent: true`.
+- `persistent` (Boolean, Standard `false`): Bei `true` läuft der Monitor ohne Timeout für die gesamte Sitzung. Mit `TaskStop` explizit stoppen.
+
+## Beispiele
+
+### Beispiel 1: Logdatei auf Fehler und Abstürze überwachen
+
+Dieses Beispiel deckt alle Endzustände ab: Erfolgsmarkierung, Traceback, gängige Fehlerschlüsselwörter, OOM-Abbruch und unerwarteten Prozessabbruch.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+`grep --line-buffered` in jeder Pipe verwenden. Ohne diese Option puffert das Betriebssystem die Ausgabe in 4-KB-Blöcken, was zu Verzögerungen von Minuten führt. Das Alternierungsmuster deckt sowohl den Erfolgspfad (`deployed`) als auch Fehlerpfade (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`) ab. Ein Monitor, der nur auf die Erfolgsmarkierung wartet, bleibt bei einem Absturz stumm — Stille sieht identisch aus wie "läuft noch".
+
+### Beispiel 2: Remote-API alle 30 Sekunden abfragen
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` verhindert, dass ein vorübergehender Netzwerkfehler die Schleife beendet. Für Remote-APIs sind Abfrageintervalle von 30 Sekunden oder mehr empfehlenswert, um Rate-Limits zu vermeiden. Das Grep-Muster anpassen, um sowohl Erfolgs- als auch Fehlerantworten zu erfassen, damit API-seitige Fehler nicht durch Stille verdeckt werden.
+
+## Hinweise
+
+- **Immer `grep --line-buffered` in Pipes verwenden.** Ohne diese Option verzögert das Pipe-Buffering Ereignisse um Minuten, da das Betriebssystem die Ausgabe bis zum Füllen eines 4-KB-Blocks akkumuliert. `--line-buffered` erzwingt einen Flush nach jeder Zeile.
+- **Der Filter muss sowohl Erfolgs- als auch Fehlersignaturen abdecken.** Ein Monitor, der nur auf die Erfolgsmarkierung wartet, bleibt bei Absturz, Hänger oder unerwartetem Beenden stumm. Das Alternierungsmuster erweitern: Neben dem Erfolgsschlüsselwort auch `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` und ähnliche Endzustandsmarkierungen einschließen.
+- **Abfrageintervalle: 30 Sekunden oder mehr für Remote-APIs.** Häufiges Abfragen externer Dienste riskiert Rate-Limit-Fehler oder Sperrungen. Für lokale Dateisystem- oder Prozessüberprüfungen sind 0,5–1 Sekunde angemessen.
+- **`persistent: true` für sitzungsweite Monitore.** Der Standard-`timeout_ms` von 300.000 ms (5 Minuten) beendet den Prozess. Für Monitore, die bis zur expliziten Beendigung laufen sollen, `persistent: true` setzen und nach Abschluss `TaskStop` aufrufen.
+- **Automatisches Stoppen bei Ereignisflut.** Jede Zeile der Standardausgabe ist eine Konversationsnachricht. Wenn der Filter zu breit ist und zu viele Ereignisse erzeugt, wird der Monitor automatisch gestoppt. Mit einem engeren `grep`-Muster neu starten. Zeilen, die innerhalb von 200 ms eintreffen, werden zu einer Benachrichtigung zusammengefasst.

package/concepts/de/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Definition
+Ändert eine einzelne Zelle in einem Jupyter-Notebook (`.ipynb`). Unterstützt das Ersetzen der Zellenquelle, das Einfügen einer neuen Zelle oder das Löschen einer bestehenden Zelle, während die übrige Notebook-Struktur erhalten bleibt.
 
-Ersetzt, fügt ein oder löscht bestimmte Zellen in einem Jupyter Notebook (.ipynb-Datei).
+## Wann verwenden
+
+- Korrigieren oder Aktualisieren einer Code-Zelle in einem Analyse-Notebook, ohne die gesamte Datei neu zu schreiben
+- Austauschen einer Markdown-Zelle, um die Erzählung zu verbessern oder Dokumentation hinzuzufügen
+- Einfügen einer neuen Code- oder Markdown-Zelle an einer bekannten Position in einem bestehenden Notebook
+- Entfernen einer veralteten oder defekten Zelle, damit nachgeschaltete Zellen nicht mehr von ihr abhängen
+- Vorbereiten eines reproduzierbaren Notebooks durch iteratives Bearbeiten einer Zelle nach der anderen
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `notebook_path` | string | Ja | Absoluter Pfad der Notebook-Datei |
-| `new_source` | string | Ja | Neuer Inhalt der Zelle |
-| `cell_id` | string | Nein | ID der zu bearbeitenden Zelle. Im Einfügemodus wird die neue Zelle nach dieser ID eingefügt |
-| `cell_type` | enum | Nein | Zellentyp: `code` oder `markdown`. Im Einfügemodus erforderlich |
-| `edit_mode` | enum | Nein | Bearbeitungsmodus: `replace` (Standard), `insert`, `delete` |
+- `notebook_path` (string, erforderlich): Absoluter Pfad zur `.ipynb`-Datei. Relative Pfade werden abgelehnt.
+- `new_source` (string, erforderlich): Die neue Zellenquelle. Für `replace` und `insert` wird sie der Zellenkörper; für `delete` wird sie ignoriert, ist aber im Schema dennoch erforderlich.
+- `cell_id` (string, optional): ID der Zielzelle. In den Modi `replace` und `delete` wirkt das Tool auf diese Zelle. Im `insert`-Modus wird die neue Zelle unmittelbar nach der Zelle mit dieser ID eingefügt; weglassen, um ganz oben einzufügen.
+- `cell_type` (enum, optional): Entweder `code` oder `markdown`. Erforderlich, wenn `edit_mode` `insert` ist. Beim Weglassen während `replace` wird der Typ der bestehenden Zelle beibehalten.
+- `edit_mode` (enum, optional): `replace` (Standard), `insert` oder `delete`.
 
-## Anwendungsfälle
+## Beispiele
 
-**Geeignet für:**
-- Code- oder Markdown-Zellen in Jupyter Notebooks ändern
-- Neue Zellen zum Notebook hinzufügen
-- Zellen aus dem Notebook löschen
+### Beispiel 1: Eine fehlerhafte Code-Zelle ersetzen
+`NotebookEdit` mit `notebook_path` als absolutem Pfad, `cell_id` als ID der Zielzelle und `new_source` mit dem korrigierten Python-Code aufrufen. `edit_mode` beim Standardwert `replace` belassen.
 
-## Hinweise
+### Beispiel 2: Eine Markdown-Erklärung einfügen
+Um eine Markdown-Zelle direkt nach einer bestehenden `setup`-Zelle hinzuzufügen, `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` auf die ID der Setup-Zelle setzen und den Fließtext in `new_source` schreiben.
 
-- `cell_number` ist 0-indiziert
-- `insert`-Modus fügt eine neue Zelle an der angegebenen Position ein
-- `delete`-Modus löscht die Zelle an der angegebenen Position
-- Der Pfad muss ein absoluter Pfad sein
+### Beispiel 3: Eine veraltete Zelle löschen
+`edit_mode: "delete"` setzen und die `cell_id` der zu entfernenden Zelle angeben. Einen beliebigen String für `new_source` übergeben; er wird nicht angewendet.
 
-## Originaltext
+## Hinweise
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Immer einen absoluten Pfad übergeben. `NotebookEdit` löst keine relativen Pfade gegen das Arbeitsverzeichnis auf.
+- Das Tool schreibt nur die Zielzelle neu; Ausführungszähler, Outputs und Metadaten unbeteiligter Zellen bleiben unberührt.
+- Ein Einfügen ohne `cell_id` platziert die neue Zelle ganz am Anfang des Notebooks.
+- `cell_type` ist für Einfügungen zwingend. Bei Ersetzungen weglassen, sofern Sie nicht ausdrücklich eine Code-Zelle in Markdown umwandeln möchten oder umgekehrt.
+- Um Zellen zu inspizieren und ihre IDs zu erhalten, verwenden Sie zunächst das `Read`-Tool auf dem Notebook; es liefert die Zellen mit Inhalt und Outputs zurück.
+- Verwenden Sie das reguläre `Edit` für einfache Quelldateien; `NotebookEdit` ist spezifisch für `.ipynb`-JSON und versteht dessen Zellenstruktur.

package/concepts/de/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Sendet eine Desktop-Benachrichtigung aus der aktuellen Claude Code-Sitzung. Wenn Remote Control verbunden ist, wird die Benachrichtigung auch auf das Smartphone des Benutzers übertragen und lenkt dessen Aufmerksamkeit von der aktuellen Tätigkeit zurück zur Sitzung.
+
+## Wann verwenden
+
+- Eine lang laufende Aufgabe wurde abgeschlossen, während der Benutzer wahrscheinlich nicht am Terminal war
+- Ein Build, Testlauf oder Deployment wurde abgeschlossen und das Ergebnis kann überprüft werden
+- Es wurde ein Entscheidungspunkt erreicht, an dem Benutzereingaben erforderlich sind, bevor die Arbeit fortgesetzt werden kann
+- Ein Fehler oder Blocker ist aufgetreten, der nicht autonom gelöst werden kann
+- Der Benutzer hat ausdrücklich darum gebeten, benachrichtigt zu werden, wenn eine bestimmte Aufgabe oder Bedingung erfüllt ist
+
+## Wann nicht verwenden
+
+Senden Sie keine Benachrichtigung für routinemäßige Fortschrittsaktualisierungen während einer Aufgabe oder um zu bestätigen, dass eine Frage beantwortet wurde, auf die der Benutzer gerade wartet. Bei kurzen Aufgaben ist keine Benachrichtigung notwendig — wenn der Benutzer die Aufgabe gerade eingereicht hat und wartet, bietet eine Benachrichtigung keinen Mehrwert und mindert das Vertrauen in künftige Benachrichtigungen. Tendenziell sollte keine Benachrichtigung gesendet werden.
+
+## Parameter
+
+- `message` (Zeichenkette, erforderlich): Der Benachrichtigungstext. Unter 200 Zeichen halten; mobile Betriebssysteme kürzen längere Zeichenketten. Mit handlungsrelevantem Inhalt beginnen: "build failed: 2 auth tests" ist aussagekräftiger als "task complete".
+- `status` (Zeichenkette, erforderlich): Immer auf `"proactive"` setzen. Dies ist ein fester Marker und wird nicht geändert.
+
+## Beispiele
+
+### Beispiel 1: Benachrichtigung nach Abschluss einer langen Analyse
+
+Eine repository-weite Abhängigkeitsprüfung wurde angefordert und dauerte mehrere Minuten. Der Benutzer hat den Arbeitsplatz verlassen. Wenn der Bericht fertig ist:
+
+```
+message: "Dependency-Audit abgeschlossen: 3 kritische CVEs in lodash, axios, jsonwebtoken. Bericht: audit-report.txt"
+status: "proactive"
+```
+
+### Beispiel 2: Entscheidungspunkt bei autonomer Arbeit markieren
+
+Während eines mehrstufigen Refactorings wird festgestellt, dass zwei Module inkompatible Schnittstellen haben und ohne eine Designentscheidung nicht zusammengeführt werden können:
+
+```
+message: "Refactoring pausiert: AuthService und UserService haben konflikthafte Token-Schnittstellen. Ihre Entscheidung wird benötigt."
+status: "proactive"
+```
+
+## Hinweise
+
+- Tendieren Sie stark dazu, **keine** Benachrichtigung zu senden. Die Benachrichtigung unterbricht den Benutzer unabhängig davon, was er gerade tut. Behandeln Sie sie als Kosten, die durch den Informationswert gerechtfertigt werden müssen.
+- Mit handlungsrelevantem Inhalt beginnen. Die ersten Wörter sollten mitteilen, was passiert ist und was, falls überhaupt etwas, zu tun ist — kein generisches Statuslabel.
+- `message` unter 200 Zeichen halten. Mobile Betriebssysteme kürzen längere Zeichenketten, wodurch der wichtigste Teil am Ende verloren gehen kann.
+- Wenn das Ergebnis anzeigt, dass der Push nicht gesendet wurde, weil Remote Control nicht verbunden ist, ist das erwartetes Verhalten. Kein Neuversuch oder weitere Maßnahmen erforderlich; die lokale Desktop-Benachrichtigung wird dennoch ausgelöst.
+- Benachrichtigungs-Spam vermeiden. Wenn häufig für Kleinigkeiten Benachrichtigungen gesendet werden, beginnt der Benutzer, diese zu ignorieren. Dieses Tool sollte für Momente reserviert werden, in denen der Benutzer sehr wahrscheinlich nicht anwesend ist und das Ergebnis sofort wissen möchte.

package/concepts/de/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Definition
+Lädt den Inhalt einer einzelnen Datei aus dem lokalen Dateisystem. Unterstützt Klartext, Quellcode, Bilder, PDFs und Jupyter-Notebooks und gibt die Ergebnisse mit 1-basierten Zeilennummern im `cat -n`-Stil zurück.
 
-Liest Dateiinhalte aus dem lokalen Dateisystem. Unterstützt Textdateien, Bilder, PDF und Jupyter Notebooks.
+## Wann verwenden
+
+- Lesen einer Quelldatei an einem bekannten Pfad vor Bearbeitung oder Analyse
+- Inspizieren von Konfigurationsdateien, Lockfiles, Logs oder generierten Artefakten
+- Anzeigen von Screenshots oder Diagrammen, die der Benutzer in die Unterhaltung eingefügt hat
+- Extrahieren eines bestimmten Seitenbereichs aus einem langen PDF-Handbuch
+- Öffnen eines `.ipynb`-Notebooks, um Code-Zellen, Markdown und Zellenausgaben gemeinsam zu überprüfen
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `file_path` | string | Ja | Absoluter Pfad der Datei |
-| `offset` | number | Nein | Startzeilennummer (für abschnittsweises Lesen großer Dateien) |
-| `limit` | number | Nein | Anzahl zu lesender Zeilen (für abschnittsweises Lesen großer Dateien) |
-| `pages` | string | Nein | PDF-Seitenbereich (z.B. "1-5", "3", "10-20"), nur für PDF |
+- `file_path` (string, erforderlich): Absoluter Pfad zur Zieldatei. Relative Pfade werden abgelehnt.
+- `offset` (integer, optional): 1-basierte Zeilennummer, ab der gelesen wird. Nützlich für große Dateien in Kombination mit `limit`.
+- `limit` (integer, optional): Maximale Anzahl zurückzugebender Zeilen ab `offset`. Standard sind 2000 Zeilen vom Dateianfang, wenn weggelassen.
+- `pages` (string, optional): Seitenbereich für PDF-Dateien, zum Beispiel `"1-5"`, `"3"` oder `"10-20"`. Erforderlich für PDFs länger als 10 Seiten; maximal 20 Seiten pro Anfrage.
+
+## Beispiele
+
+### Beispiel 1: Eine gesamte kleine Datei lesen
+`Read` nur mit `file_path` auf `/Users/me/project/src/index.ts` aufrufen. Bis zu 2000 Zeilen werden mit Zeilennummern zurückgegeben, was normalerweise als Bearbeitungskontext ausreicht.
 
-## Anwendungsfälle
+### Beispiel 2: Durch ein langes Log blättern
+`offset: 5001` und `limit: 500` für eine Log-Datei mit mehreren Tausend Zeilen verwenden, um ein schmales Fenster abzurufen, ohne Kontext-Token zu verschwenden.
 
-**Geeignet für:**
-- Codedateien, Konfigurationsdateien und andere Textdateien lesen
-- Bilddateien anzeigen (Claude ist ein multimodales Modell)
-- PDF-Dokumente lesen
-- Jupyter Notebooks lesen (gibt alle Zellen mit Ausgaben zurück)
-- Mehrere Dateien parallel lesen, um Kontext zu erhalten
+### Beispiel 3: Bestimmte PDF-Seiten extrahieren
+Für ein 120-seitiges PDF unter `/tmp/spec.pdf` `pages: "8-15"` setzen, um nur das benötigte Kapitel herauszuziehen. Das Weglassen von `pages` bei einem großen PDF erzeugt einen Fehler.
 
-**Nicht geeignet für:**
-- Verzeichnisse lesen – dafür den `ls`-Befehl in Bash verwenden
-- Offene Codebasis-Erkundung – dafür Task (Explore-Typ) verwenden
+### Beispiel 4: Ein Bild anzeigen
+Den absoluten Pfad eines PNG- oder JPG-Screenshots übergeben. Das Bild wird visuell gerendert, sodass Claude Code direkt darüber schlussfolgern kann.
 
 ## Hinweise
 
-- Der Pfad muss ein absoluter Pfad sein, kein relativer Pfad
-- Standardmäßig werden die ersten 2000 Zeilen der Datei gelesen
-- Zeilen mit mehr als 2000 Zeichen werden abgeschnitten
-- Die Ausgabe verwendet das `cat -n`-Format, Zeilennummern beginnen bei 1
-- Große PDFs (über 10 Seiten) erfordern den `pages`-Parameter, maximal 20 Seiten pro Aufruf
-- Das Lesen einer nicht existierenden Datei gibt einen Fehler zurück (kein Absturz)
-- Mehrere Read-Aufrufe können in einer einzelnen Nachricht parallel ausgeführt werden
-
-## Originaltext
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- Immer absolute Pfade bevorzugen. Wenn der Benutzer einen angibt, vertrauen Sie ihm so, wie er ist.
+- Zeilen länger als 2000 Zeichen werden gekürzt; behandeln Sie den zurückgegebenen Inhalt bei extrem breiten Daten als potenziell abgeschnitten.
+- Mehrere unabhängige Dateien lesen? Setzen Sie mehrere `Read`-Aufrufe in derselben Antwort ab, damit sie parallel laufen.
+- `Read` kann keine Verzeichnisse auflisten. Verwenden Sie stattdessen einen `Bash`-`ls`-Aufruf oder das `Glob`-Tool.
+- Das Lesen einer vorhandenen, aber leeren Datei liefert eine System-Erinnerung statt Dateibytes, also behandeln Sie dieses Signal explizit.
+- Ein erfolgreiches `Read` ist erforderlich, bevor Sie `Edit` auf derselben Datei in der aktuellen Sitzung verwenden können.

package/concepts/de/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Ruft die claude.ai Remote-Trigger-API auf, um geplante Aufgaben und bedarfsgesteuerte Trigger-Ausführungen zu verwalten. Das OAuth-Token wird intern vom Tool verarbeitet und ist weder für das Modell noch für die Shell sichtbar.
+
+## Wann verwenden
+
+- Verwaltung von Remote-Agenten (Triggern) auf claude.ai — einschließlich Auflisten, Prüfen und Aktualisieren vorhandener Trigger
+- Erstellen einer neuen cron-basierten automatisierten Aufgabe, die einen Claude-Agenten nach einem wiederkehrenden Zeitplan ausführt
+- Manuelles Ausführen eines vorhandenen Triggers ohne Warten auf den nächsten geplanten Zeitpunkt
+- Auflisten oder Überprüfen aller aktuellen Trigger, um deren Konfiguration und Status zu prüfen
+- Aktualisieren von Trigger-Einstellungen wie Zeitplan, Payload oder Beschreibung, ohne den Trigger neu erstellen zu müssen
+
+## Parameter
+
+- `action` (string, erforderlich): die auszuführende Operation — eines von `list`, `get`, `create`, `update` oder `run`
+- `trigger_id` (string, erforderlich für `get`, `update` und `run`): der Bezeichner des Triggers, der bearbeitet werden soll; muss dem Muster `^[\w-]+$` entsprechen (nur Wortzeichen und Bindestriche)
+- `body` (object, erforderlich für `create` und `update`; optional für `run`): die an die API gesendete Anfrage-Payload
+
+## Beispiele
+
+### Beispiel 1: Alle Trigger auflisten
+
+```json
+{
+  "action": "list"
+}
+```
+
+Ruft `GET /v1/code/triggers` auf und gibt ein JSON-Array aller Trigger zurück, die mit dem authentifizierten Konto verknüpft sind.
+
+### Beispiel 2: Einen neuen Trigger erstellen, der jeden Werktag morgens ausgeführt wird
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Täglich eine Zusammenfassung an jedem Werktag um 08:00 UTC erstellen"
+  }
+}
+```
+
+Ruft `POST /v1/code/triggers` mit dem angegebenen Body auf und gibt das neu erstellte Trigger-Objekt zurück, einschließlich der zugewiesenen `trigger_id`.
+
+### Beispiel 3: Einen Trigger sofort ausführen
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Ruft sofort `POST /v1/code/triggers/my-report-trigger/run` auf und umgeht dabei den geplanten Zeitpunkt.
+
+### Beispiel 4: Einen einzelnen Trigger abrufen
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Ruft `GET /v1/code/triggers/my-report-trigger` auf und gibt die vollständige Trigger-Konfiguration zurück.
+
+## Hinweise
+
+- Das OAuth-Token wird vom Tool prozessintern injiziert — kopieren, einfügen oder protokollieren Sie Token niemals manuell; dies stellt ein Sicherheitsrisiko dar und ist bei der Verwendung dieses Tools nicht erforderlich.
+- Verwenden Sie dieses Tool für alle Trigger-API-Aufrufe anstelle von rohem `curl` oder anderen HTTP-Clients; die direkte Verwendung von HTTP umgeht die sichere Token-Injektion und kann Anmeldedaten offenlegen.
+- Das Tool gibt die rohe JSON-Antwort der API zurück; der Aufrufer ist für das Parsen der Antwort und die Behandlung von Fehlerstatuscodes verantwortlich.
+- Der `trigger_id`-Wert muss dem Muster `^[\w-]+$` entsprechen — nur alphanumerische Zeichen, Unterstriche und Bindestriche sind zulässig; Leerzeichen oder Sonderzeichen führen dazu, dass die Anfrage fehlschlägt.

package/concepts/de/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+Plant, wann die Arbeit im `/loop`-Dynamikmodus wiederaufgenommen werden soll. Das Tool ermöglicht es Claude, das Iterationstempo einer Aufgabe selbstständig zu steuern, für ein gewähltes Intervall zu schlafen und dann mit demselben Loop-Prompt erneut zu feuern.
+
+## Wann verwenden
+
+- Beim eigenständigen Steuern des Tempos einer `/loop`-Dynamikaufgabe, bei der das Iterationsintervall vom Arbeitsstatus und nicht von einer festen Uhr abhängt
+- Beim Warten auf den Abschluss eines langen Builds, Deployments oder Testlaufs, bevor Ergebnisse geprüft werden
+- Beim Einfügen von Leerlauf-Ticks zwischen Iterationen, wenn gerade kein bestimmtes Signal zu beobachten ist
+- Beim Ausführen einer autonomen Schleife ohne Benutzer-Prompt — den literalen Sentinel `<<autonomous-loop-dynamic>>` als `prompt` übergeben
+- Beim Abfragen eines Prozesses, dessen Zustand sich bald ändern wird (kurze Verzögerung zum Warmhalten des Caches)
+
+## Parameter
+
+- `delaySeconds` (Zahl, erforderlich): Sekunden bis zur Wiederaufnahme. Die Laufzeit begrenzt den Wert automatisch auf `[60, 3600]`, sodass keine manuelle Begrenzung erforderlich ist.
+- `reason` (Zeichenkette, erforderlich): Ein kurzer Satz zur Erläuterung der gewählten Verzögerung. Wird dem Benutzer angezeigt und in der Telemetrie aufgezeichnet. Seien Sie konkret — „langer bun-Build wird geprüft" ist hilfreicher als „warten."
+- `prompt` (Zeichenkette, erforderlich): Die beim Aufwachen auszulösende `/loop`-Eingabe. Bei jeder Runde dieselbe Zeichenkette übergeben, damit das nächste Feuern die Aufgabe wiederholt. Für eine autonome Schleife ohne Benutzer-Prompt den literalen Sentinel `<<autonomous-loop-dynamic>>` übergeben.
+
+## Beispiele
+
+### Beispiel 1: Kurze Verzögerung zum erneuten Prüfen eines sich schnell ändernden Signals (Cache warm halten)
+
+Ein Build wurde gerade gestartet und dauert typischerweise zwei bis drei Minuten.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "bun-Build wird geprüft, voraussichtlich fertig in ~2 Min",
+  "prompt": "Build-Status prüfen und Fehler melden"
+}
+```
+
+120 Sekunden halten den Gesprächskontext im Anthropic-Prompt-Cache (TTL 5 Min.), sodass das nächste Aufwachen schneller und günstiger ist.
+
+### Beispiel 2: Langer Leerlauf-Tick (Cache-Miss akzeptieren, über längere Wartezeit amortisieren)
+
+Eine Datenbankmigrierung läuft und dauert typischerweise 20–40 Minuten.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "Migration dauert typisch 20–40 Min.; in 20 Min. erneut prüfen",
+  "prompt": "Migrationsstatus prüfen und bei Abschluss fortfahren"
+}
+```
+
+Beim Aufwachen ist der Cache kalt, aber die 20-minütige Wartezeit amortisiert den einzelnen Cache-Miss mehr als ausreichend. Alle 5 Minuten abzufragen würde denselben Miss-Preis viermal zahlen, ohne Nutzen.
+
+## Hinweise
+
+- **5-Minuten-Cache-TTL**: Der Anthropic-Prompt-Cache läuft nach 300 Sekunden ab. Verzögerungen unter 300 s halten den Kontext warm; Verzögerungen über 300 s verursachen beim nächsten Aufwachen einen Cache-Miss.
+- **Genau 300 s vermeiden**: Das ist das schlechteste Ergebnis beider Welten — der Cache-Miss wird bezahlt, ohne eine sinnvoll längere Wartezeit zu erhalten. Entweder auf 270 s reduzieren (Cache warm halten) oder auf 1200 s oder mehr festlegen (ein Miss kauft eine deutlich längere Wartezeit).
+- **Standard für Leerlauf-Ticks**: Wenn kein bestimmtes Signal zu beobachten ist, **1200–1800 s** (20–30 Min.) verwenden. So prüft die Schleife regelmäßig, ohne 12× pro Stunde den Cache ohne Grund zu verbrennen.
+- **Automatische Begrenzung**: Die Laufzeit begrenzt `delaySeconds` auf `[60, 3600]`. Werte unter 60 werden zu 60; Werte über 3600 werden zu 3600. Diese Grenzen müssen nicht selbst gehandhabt werden.
+- **Aufruf weglassen zum Beenden der Schleife**: Wenn Iterationen gestoppt werden sollen, ScheduleWakeup nicht aufrufen. Das bloße Weglassen des Aufrufs beendet die Schleife.
+- **Jede Runde denselben `prompt` übergeben**: Das `prompt`-Feld muss bei jedem Aufruf die ursprüngliche `/loop`-Anweisung enthalten, damit das nächste Aufwachen weiß, welche Aufgabe fortgesetzt werden soll.

package/concepts/de/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Definition
+Liefert eine Nachricht von einem Teammitglied an ein anderes innerhalb eines aktiven Teams, oder sendet eine Rundnachricht an alle Teammitglieder gleichzeitig. Dies ist der einzige Kanal, den Teammitglieder hören können – alles, was in normale Textausgabe geschrieben wird, ist für sie unsichtbar.
 
-Sendet Nachrichten zwischen Agenten innerhalb eines Teams. Wird für direkte Kommunikation, Broadcasting und Protokollnachrichten (Shutdown-Anfragen/-Antworten, Plan-Genehmigung) verwendet.
+## Wann verwenden
+
+- Zuweisen einer Aufgabe oder Übergeben eines Teilproblems an ein namentlich bekanntes Teammitglied während der Team-Zusammenarbeit.
+- Anfragen nach Status, Zwischenergebnissen oder einer Code-Review von einem anderen Agenten.
+- Rundsenden einer Entscheidung, gemeinsamen Einschränkung oder Shutdown-Ankündigung an das gesamte Team per `*`.
+- Antworten auf einen Protokoll-Prompt wie eine Shutdown-Anfrage oder eine Plan-Genehmigungsanfrage des Teamleiters.
+- Abschließen einer delegierten Aufgabe am Ende, damit der Leiter den Punkt als erledigt markieren kann.
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `to` | string | Ja | Empfänger: Teammitglied-Name oder `"*"` für Broadcast an alle |
-| `message` | string / object | Ja | Klartextnachricht oder strukturiertes Protokollobjekt |
-| `summary` | string | Nein | Eine 5-10 Wörter umfassende Vorschau in der UI |
+- `to` (string, erforderlich): Der `name` des Zielteammitglieds, wie im Team registriert, oder `*` für eine Rundnachricht an alle Teammitglieder.
+- `message` (string oder object, erforderlich): Klartext für normale Kommunikation, oder ein strukturiertes Objekt für Protokoll-Antworten wie `shutdown_response` und `plan_approval_response`.
+- `summary` (string, optional): Eine 5–10 Wörter lange Vorschau, die im Team-Aktivitätsprotokoll für Klartextnachrichten angezeigt wird. Erforderlich für lange String-Nachrichten; wird ignoriert, wenn `message` ein Protokoll-Objekt ist.
+
+## Beispiele
+
+### Beispiel 1: Direkte Aufgabenübergabe
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Nachrichtentypen
+### Beispiel 2: Eine gemeinsame Einschränkung rundsenden
 
-### Klartext
-Direktnachrichten zwischen Teammitgliedern zur Koordination, Statusaktualisierung und Aufgabenbesprechung.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Shutdown-Anfrage
-Fordert ein Teammitglied zum geordneten Herunterfahren auf: `{ type: "shutdown_request", reason: "..." }`
+### Beispiel 3: Protokollantwort
 
-### Shutdown-Antwort
-Teammitglied genehmigt oder lehnt das Herunterfahren ab: `{ type: "shutdown_response", approve: true/false }`
+Auf eine Shutdown-Anfrage des Leiters mit einer strukturierten Nachricht antworten:
 
-### Plan-Genehmigungs-Antwort
-Genehmigt oder lehnt den Plan eines Teammitglieds ab: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Broadcast vs. Direkt
+### Beispiel 4: Plan-Genehmigungsantwort
 
-- **Direkt** (`to: "Teammitglied-Name"`): An ein bestimmtes Teammitglied senden — bevorzugt für die meiste Kommunikation
-- **Broadcast** (`to: "*"`): An alle Teammitglieder senden — nur sparsam für kritische teamweite Ankündigungen verwenden
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## Verwandte Tools
+## Hinweise
 
-| Tool | Zweck |
-|------|-------|
-| `TeamCreate` | Neues Team erstellen |
-| `TeamDelete` | Team nach Abschluss entfernen |
-| `Agent` | Teammitglieder starten, die dem Team beitreten |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Gemeinsame Aufgabenliste verwalten |
+- Ihre reguläre Assistenten-Textausgabe wird NICHT an Teammitglieder übertragen. Wenn ein anderer Agent etwas sehen soll, muss es durch `SendMessage` laufen. Dies ist der häufigste Fehler in Team-Workflows.
+- Rundnachricht (`to: "*"`) ist teuer – sie weckt jedes Teammitglied und verbraucht dessen Kontext. Reservieren Sie sie für Ankündigungen, die wirklich alle betreffen. Bevorzugen Sie gezielte Sendungen.
+- Halten Sie Nachrichten prägnant und handlungsorientiert. Fügen Sie Dateipfade, Einschränkungen und das erwartete Antwortformat ein, das der Empfänger benötigt; denken Sie daran, dass er keinen gemeinsamen Speicher mit Ihnen hat.
+- Protokoll-Nachrichtenobjekte (`shutdown_response`, `plan_approval_response`) haben feste Formen. Mischen Sie keine Protokollfelder in Klartextnachrichten und umgekehrt.
+- Nachrichten sind asynchron. Der Empfänger erhält Ihre in seinem nächsten Turn; gehen Sie nicht davon aus, dass er sie gelesen oder darauf reagiert hat, bis er antwortet.
+- Eine gut geschriebene `summary` macht das Team-Aktivitätsprotokoll für den Leiter überfliegbar – behandeln Sie sie wie eine Commit-Betreffzeile.