cc-viewer 1.2.1 → 1.2.2

package/concepts/de/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Definition
+
+Verlässt den Planungsmodus und reicht den Plan zur Benutzerfreigabe ein. Der Planinhalt wird aus der zuvor geschriebenen Plandatei gelesen.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `allowedPrompts` | array | Nein | Liste der für die Planumsetzung benötigten Berechtigungsbeschreibungen |
+
+Jedes Element im `allowedPrompts`-Array:
+
+| Feld | Typ | Erforderlich | Beschreibung |
+|------|-----|--------------|--------------|
+| `tool` | enum | Ja | Das zutreffende Tool, derzeit nur `Bash` unterstützt |
+| `prompt` | string | Ja | Semantische Beschreibung der Operation (z.B. "run tests", "install dependencies") |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Der Plan im Planungsmodus ist fertig und bereit zur Benutzerfreigabe
+- Nur für Implementierungsaufgaben, die Code schreiben erfordern
+
+**Nicht geeignet für:**
+- Reine Recherche-/Erkundungsaufgaben – kein Verlassen des Planungsmodus nötig
+- Den Benutzer fragen „Ist der Plan in Ordnung?" – genau das ist die Funktion dieses Tools, verwenden Sie nicht AskUserQuestion dafür
+
+## Hinweise
+
+- Dieses Tool akzeptiert keinen Planinhalt als Parameter – es liest aus der zuvor geschriebenen Plandatei
+- Der Benutzer sieht den Inhalt der Plandatei zur Genehmigung
+- Verwenden Sie nicht AskUserQuestion vor dem Aufruf dieses Tools, um zu fragen „Ist der Plan in Ordnung?" – das wäre redundant
+- Erwähnen Sie den „Plan" nicht in Fragen, da der Benutzer den Planinhalt vor ExitPlanMode nicht sehen kann
+
+## Bedeutung in cc-viewer
+
+Der ExitPlanMode-Aufruf markiert das Ende der Planungsphase. Im Anfrage-Log wechseln die Anfragen nach diesem Aufruf typischerweise zu Implementierungsoperationen (Edit, Write, Bash usw.).

package/concepts/de/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Definition
+
+Schnelles Dateinamen-Musterabgleich-Tool, das mit Codebasen jeder Größe funktioniert. Gibt übereinstimmende Dateipfade sortiert nach Änderungszeit zurück.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `pattern` | string | Ja | Glob-Muster (z.B. `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Nein | Suchverzeichnis, Standard ist das aktuelle Arbeitsverzeichnis. Nicht "undefined" oder "null" übergeben |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Dateien nach Dateinamenmuster suchen
+- Alle Dateien eines bestimmten Typs finden (z.B. alle `.tsx`-Dateien)
+- Beim Suchen einer bestimmten Klassendefinition (z.B. `class Foo`) zuerst die Datei lokalisieren
+- Mehrere Glob-Aufrufe können in einer einzelnen Nachricht parallel gestartet werden
+
+**Nicht geeignet für:**
+- Dateiinhalte durchsuchen – dafür Grep verwenden
+- Offene Erkundung mit mehreren Suchrunden – dafür Task (Explore-Typ) verwenden
+
+## Hinweise
+
+- Unterstützt Standard-Glob-Syntax: `*` matcht eine Ebene, `**` matcht mehrere Ebenen, `{}` matcht Alternativen
+- Ergebnisse sind nach Änderungszeit sortiert
+- Wird gegenüber dem `find`-Befehl in Bash bevorzugt
+
+## Bedeutung in cc-viewer
+
+Glob-Aufrufe erscheinen im Anfrage-Log als `tool_use` / `tool_result` Content-Block-Paare. `tool_result` enthält die Liste der übereinstimmenden Dateipfade.

package/concepts/de/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Definition
+
+Leistungsstarkes Inhaltssuchtool basierend auf ripgrep. Unterstützt reguläre Ausdrücke, Dateitypfilterung und mehrere Ausgabemodi.
+
+## 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
+
+## 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
+
+## Bedeutung in cc-viewer
+
+Grep-Aufrufe erscheinen im Anfrage-Log als `tool_use` / `tool_result` Content-Block-Paare. `tool_result` enthält die Suchergebnisse.

package/concepts/de/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Definition
+
+Ersetzt, fügt ein oder löscht bestimmte Zellen in einem Jupyter Notebook (.ipynb-Datei).
+
+## 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` |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Code- oder Markdown-Zellen in Jupyter Notebooks ändern
+- Neue Zellen zum Notebook hinzufügen
+- Zellen aus dem Notebook löschen
+
+## Hinweise
+
+- `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
+
+## Bedeutung in cc-viewer
+
+NotebookEdit-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block und zeichnen die konkreten Änderungsoperationen am Notebook auf.

package/concepts/de/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Definition
+
+Liest Dateiinhalte aus dem lokalen Dateisystem. Unterstützt Textdateien, Bilder, PDF und Jupyter Notebooks.
+
+## 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 |
+
+## Anwendungsfälle
+
+**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
+
+**Nicht geeignet für:**
+- Verzeichnisse lesen – dafür den `ls`-Befehl in Bash verwenden
+- Offene Codebasis-Erkundung – dafür Task (Explore-Typ) verwenden
+
+## 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
+
+## Bedeutung in cc-viewer
+
+Read-Aufrufe erscheinen im Anfrage-Log als `tool_use` (Aufruf) und `tool_result` (zurückgegebener Inhalt) Content-Block-Paare. `tool_result` enthält den tatsächlichen Dateiinhalt und kann zur Analyse verwendet werden, welche Dateien das Modell gelesen hat.

package/concepts/de/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Definition
+
+Führt einen Skill in der Hauptkonversation aus. Skills sind spezialisierte Fähigkeiten, die der Benutzer über Slash Commands (z.B. `/commit`, `/review-pr`) aufrufen kann.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `skill` | string | Ja | Skill-Name (z.B. "commit", "review-pr", "pdf") |
+| `args` | string | Nein | Skill-Argumente |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Der Benutzer hat einen Slash Command im Format `/<skill-name>` eingegeben
+- Die Anfrage des Benutzers entspricht der Funktionalität eines registrierten Skills
+
+**Nicht geeignet für:**
+- Integrierte CLI-Befehle (z.B. `/help`, `/clear`)
+- Bereits laufende Skills
+- Skill-Namen, die nicht in der Liste verfügbarer Skills stehen
+
+## Hinweise
+
+- Nach dem Aufruf wird der Skill zu einem vollständigen Prompt expandiert
+- Unterstützt vollqualifizierte Namen (z.B. `ms-office-suite:pdf`)
+- Die Liste verfügbarer Skills wird in system-reminder-Nachrichten bereitgestellt
+- Wenn ein `<command-name>`-Tag sichtbar ist, bedeutet dies, dass der Skill bereits geladen ist – direkt ausführen statt dieses Tool erneut aufzurufen
+- Einen Skill nicht erwähnen, ohne das Tool tatsächlich aufzurufen
+
+## Bedeutung in cc-viewer
+
+Skill-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block. Der nach der Skill-Expansion generierte Prompt beeinflusst den System-Prompt oder Nachrichteninhalt nachfolgender Anfragen.

package/concepts/de/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Definition
+
+Startet einen Sub-Agent (SubAgent), der komplexe mehrstufige Aufgaben autonom bearbeitet. Sub-Agents sind unabhängige Unterprozesse mit jeweils eigenen Tool-Sets und Kontext.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `prompt` | string | Ja | Aufgabenbeschreibung für den Sub-Agent |
+| `description` | string | Ja | Kurze Zusammenfassung in 3–5 Wörtern |
+| `subagent_type` | string | Ja | Sub-Agent-Typ, bestimmt das verfügbare Tool-Set |
+| `model` | enum | Nein | Modell angeben (sonnet / opus / haiku), Standard wird vom übergeordneten Agent geerbt |
+| `max_turns` | integer | Nein | Maximale Anzahl agentischer Runden |
+| `run_in_background` | boolean | Nein | Ob im Hintergrund ausgeführt werden soll; Hintergrundaufgaben geben den output_file-Pfad zurück |
+| `resume` | string | Nein | Agent-ID zum Fortsetzen, setzt die letzte Ausführung fort |
+| `isolation` | enum | Nein | Isolationsmodus, `worktree` erstellt einen temporären Git-Worktree |
+
+## Sub-Agent-Typen
+
+| Typ | Zweck | Verfügbare Tools |
+|-----|-------|------------------|
+| `Bash` | Befehlsausführung, Git-Operationen | Bash |
+| `general-purpose` | Allgemeine mehrstufige Aufgaben | Alle Tools |
+| `Explore` | Schnelle Codebasis-Erkundung | Alle Tools außer Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Implementierungsplan entwerfen | Alle Tools außer Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Claude Code Nutzungsanleitung Q&A | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Statusleiste konfigurieren | Read, Edit |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Komplexe Aufgaben, die mehrere autonome Schritte erfordern
+- Codebasis-Erkundung und Tiefenrecherche (Explore-Typ verwenden)
+- Parallele Arbeit, die eine isolierte Umgebung erfordert
+- Lang laufende Aufgaben, die im Hintergrund ausgeführt werden müssen
+
+**Nicht geeignet für:**
+- Bestimmte Dateipfade lesen – direkt Read oder Glob verwenden
+- In 2–3 bekannten Dateien suchen – direkt Read verwenden
+- Bestimmte Klassendefinitionen suchen – direkt Glob verwenden
+
+## Hinweise
+
+- Nach Abschluss gibt der Sub-Agent eine einzelne Nachricht zurück; sein Ergebnis ist für den Benutzer nicht sichtbar und muss vom Haupt-Agent weitergegeben werden
+- Mehrere parallele Task-Aufrufe können in einer einzelnen Nachricht gestartet werden, um die Effizienz zu steigern
+- Hintergrundaufgaben werden über das TaskOutput-Tool auf Fortschritt geprüft
+- Der Explore-Typ ist langsamer als direkte Glob/Grep-Aufrufe; nur verwenden, wenn einfache Suchen nicht ausreichen
+
+## Bedeutung in cc-viewer
+
+Task-Aufrufe erzeugen SubAgent-Anfrageketten, die in der Anfrageliste als eigenständige Unteranfragesequenzen unabhängig vom MainAgent sichtbar sind. SubAgent-Anfragen haben typischerweise einen kompakten System-Prompt und weniger Tool-Definitionen, was einen deutlichen Kontrast zum MainAgent bildet.

package/concepts/de/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Definition
+
+Erstellt einen strukturierten Aufgabenlisteneintrag zur Fortschrittsverfolgung, Organisation komplexer Aufgaben und Darstellung des Arbeitsfortschritts für den Benutzer.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `subject` | string | Ja | Kurzer Aufgabentitel im Imperativ (z.B. "Fix authentication bug") |
+| `description` | string | Ja | Detaillierte Beschreibung mit Kontext und Akzeptanzkriterien |
+| `activeForm` | string | Nein | Text im Verlaufsform, der während der Bearbeitung angezeigt wird (z.B. "Fixing authentication bug") |
+| `metadata` | object | Nein | Beliebige Metadaten, die der Aufgabe angehängt werden |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Komplexe mehrstufige Aufgaben (mehr als 3 Schritte)
+- Der Benutzer hat mehrere To-Do-Punkte angegeben
+- Arbeitsverfolgung im Planungsmodus
+- Der Benutzer fordert ausdrücklich eine Todo-Liste an
+
+**Nicht geeignet für:**
+- Einzelne einfache Aufgaben
+- Einfache Operationen mit weniger als 3 Schritten
+- Reine Konversation oder Informationsabfragen
+
+## Hinweise
+
+- Alle neuen Aufgaben haben den Anfangsstatus `pending`
+- `subject` im Imperativ ("Run tests"), `activeForm` in der Verlaufsform ("Running tests")
+- Nach der Erstellung können über TaskUpdate Abhängigkeiten gesetzt werden (blocks/blockedBy)
+- Vor der Erstellung sollte TaskList aufgerufen werden, um doppelte Aufgaben zu vermeiden
+
+## Bedeutung in cc-viewer
+
+TaskCreate ist eine interne Aufgabenverwaltungsoperation von Claude Code und erzeugt keine eigenständige API-Anfrage. Im Chat Mode ist jedoch der tool_use Block des Modellaufrufs sichtbar.

package/concepts/de/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Definition
+
+Ruft die vollständigen Details einer Aufgabe anhand ihrer ID ab.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `taskId` | string | Ja | Die abzurufende Aufgaben-ID |
+
+## Rückgabe
+
+- `subject` — Aufgabentitel
+- `description` — Detaillierte Anforderungen und Kontext
+- `status` — Status: `pending`, `in_progress` oder `completed`
+- `blocks` — Liste der Aufgaben, die von dieser Aufgabe blockiert werden
+- `blockedBy` — Liste der Voraussetzungsaufgaben, die diese Aufgabe blockieren
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Vollständige Beschreibung und Kontext einer Aufgabe vor Arbeitsbeginn abrufen
+- Aufgabenabhängigkeiten verstehen
+- Nach Aufgabenzuweisung vollständige Anforderungen abrufen
+
+## Hinweise
+
+- Nach dem Abrufen sollte die `blockedBy`-Liste geprüft werden, bevor mit der Arbeit begonnen wird
+- TaskList verwenden, um Zusammenfassungen aller Aufgaben anzuzeigen
+
+## Bedeutung in cc-viewer
+
+TaskGet ist eine interne Aufgabenverwaltungsoperation und erzeugt keine eigenständige API-Anfrage.

package/concepts/de/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Definition
+
+Listet alle Aufgaben in der Aufgabenliste auf, um den Gesamtfortschritt und verfügbare Arbeit einzusehen.
+
+## Parameter
+
+Keine Parameter.
+
+## Rückgabe
+
+Zusammenfassung jeder Aufgabe:
+- `id` — Aufgabenkennung
+- `subject` — Kurzbeschreibung
+- `status` — Status: `pending`, `in_progress` oder `completed`
+- `owner` — Verantwortlicher (Agent-ID), leer bedeutet nicht zugewiesen
+- `blockedBy` — Liste der unerledigten Aufgaben-IDs, die diese Aufgabe blockieren
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Verfügbare Aufgaben anzeigen (Status pending, kein Owner, nicht blockiert)
+- Gesamtfortschritt des Projekts prüfen
+- Blockierte Aufgaben finden
+- Nach Abschluss einer Aufgabe die nächste finden
+
+## Hinweise
+
+- Aufgaben bevorzugt in ID-Reihenfolge bearbeiten (niedrigste ID zuerst), da frühere Aufgaben oft Kontext für spätere liefern
+- Aufgaben mit `blockedBy` können erst nach Auflösung der Abhängigkeiten übernommen werden
+- TaskGet verwenden, um vollständige Details einer bestimmten Aufgabe abzurufen
+
+## Bedeutung in cc-viewer
+
+TaskList ist eine interne Aufgabenverwaltungsoperation und erzeugt keine eigenständige API-Anfrage.

package/concepts/de/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Definition
+
+Ruft die Ausgabe einer laufenden oder abgeschlossenen Hintergrundaufgabe ab. Geeignet für Hintergrund-Shells, asynchrone Agents und Remote-Sitzungen.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `task_id` | string | Ja | Aufgaben-ID |
+| `block` | boolean | Ja | Ob blockierend auf den Abschluss gewartet werden soll, Standard `true` |
+| `timeout` | number | Ja | Maximale Wartezeit in Millisekunden, Standard 30000, maximal 600000 |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Fortschritt von über Task (`run_in_background: true`) gestarteten Hintergrund-Agents prüfen
+- Ausführungsergebnisse von Hintergrund-Bash-Befehlen abrufen
+- Auf den Abschluss asynchroner Aufgaben warten und Ausgabe abrufen
+
+**Nicht geeignet für:**
+- Vordergrundaufgaben – diese geben Ergebnisse direkt zurück, dieses Tool ist nicht erforderlich
+
+## Hinweise
+
+- `block: true` blockiert bis zum Abschluss der Aufgabe oder Timeout
+- `block: false` für nicht-blockierende Statusprüfung
+- Die Aufgaben-ID kann über den `/tasks`-Befehl gefunden werden
+- Geeignet für alle Aufgabentypen: Hintergrund-Shells, asynchrone Agents, Remote-Sitzungen
+
+## Bedeutung in cc-viewer
+
+TaskOutput-Aufrufe erzeugen selbst keine API-Anfrage; es handelt sich um eine interne Aufgabenverwaltungsoperation von Claude Code, die nicht im Anfrage-Log erscheint.

package/concepts/de/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Definition
+
+Stoppt eine laufende Hintergrundaufgabe.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `task_id` | string | Nein | ID der zu stoppenden Hintergrundaufgabe |
+| `shell_id` | string | Nein | Veraltet, stattdessen `task_id` verwenden |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Nicht mehr benötigte lang laufende Aufgaben beenden
+- Versehentlich gestartete Hintergrundaufgaben abbrechen
+
+## Hinweise
+
+- Gibt Erfolgs- oder Fehlerstatus zurück
+- Der `shell_id`-Parameter ist veraltet; `task_id` verwenden
+
+## Bedeutung in cc-viewer
+
+TaskStop-Aufrufe erzeugen selbst keine API-Anfrage und gehören zu den internen Aufgabenverwaltungsoperationen von Claude Code.

package/concepts/de/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Definition
+
+Aktualisiert den Status, Inhalt oder die Abhängigkeiten einer Aufgabe in der Aufgabenliste.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `taskId` | string | Ja | Die zu aktualisierende Aufgaben-ID |
+| `status` | enum | Nein | Neuer Status: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Nein | Neuer Titel |
+| `description` | string | Nein | Neue Beschreibung |
+| `activeForm` | string | Nein | Text in Verlaufsform, der während der Bearbeitung angezeigt wird |
+| `owner` | string | Nein | Neuer Aufgabenverantwortlicher (Agent-Name) |
+| `metadata` | object | Nein | Zu mergende Metadaten (auf null setzen zum Löschen eines Schlüssels) |
+| `addBlocks` | string[] | Nein | Liste der Aufgaben-IDs, die von dieser Aufgabe blockiert werden |
+| `addBlockedBy` | string[] | Nein | Liste der Voraussetzungsaufgaben-IDs, die diese Aufgabe blockieren |
+
+## Status-Workflow
+
+```
+pending → in_progress → completed
+```
+
+`deleted` kann von jedem Status aus gesetzt werden und entfernt die Aufgabe dauerhaft.
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Aufgabe bei Arbeitsbeginn als `in_progress` markieren
+- Aufgabe nach Abschluss als `completed` markieren
+- Abhängigkeiten zwischen Aufgaben festlegen
+- Aufgabeninhalt bei Anforderungsänderungen aktualisieren
+
+**Wichtige Regeln:**
+- Nur als `completed` markieren, wenn die Aufgabe vollständig abgeschlossen ist
+- Bei Fehlern oder Blockaden den Status `in_progress` beibehalten
+- Nicht als `completed` markieren bei: fehlgeschlagenen Tests, unvollständiger Implementierung, ungelösten Fehlern
+
+## Hinweise
+
+- Vor der Aktualisierung den aktuellen Status über TaskGet abrufen, um veraltete Daten zu vermeiden
+- Nach Abschluss einer Aufgabe TaskList aufrufen, um die nächste verfügbare Aufgabe zu finden
+
+## Bedeutung in cc-viewer
+
+TaskUpdate ist eine interne Aufgabenverwaltungsoperation und erzeugt keine eigenständige API-Anfrage.

package/concepts/de/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Definition
+
+Ruft den Inhalt einer angegebenen URL ab, konvertiert HTML in Markdown und verarbeitet den Inhalt mit einem KI-Modell basierend auf dem Prompt.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `url` | string (URI) | Ja | Die vollständige abzurufende URL |
+| `prompt` | string | Ja | Beschreibt, welche Informationen von der Seite extrahiert werden sollen |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Inhalte öffentlicher Webseiten abrufen
+- Online-Dokumentation nachschlagen
+- Bestimmte Informationen aus Webseiten extrahieren
+
+**Nicht geeignet für:**
+- URLs, die Authentifizierung erfordern (Google Docs, Confluence, Jira, GitHub usw.) – zuerst nach einem dedizierten MCP-Tool suchen
+- GitHub-URLs – bevorzugt `gh` CLI verwenden
+
+## Hinweise
+
+- Die URL muss eine vollständige gültige URL sein
+- HTTP wird automatisch auf HTTPS hochgestuft
+- Bei sehr großen Inhalten können die Ergebnisse zusammengefasst werden
+- Enthält einen sich selbst bereinigenden 15-Minuten-Cache
+- Wenn die URL zu einem anderen Host weiterleitet, gibt das Tool die Weiterleitungs-URL zurück; eine erneute Anfrage mit der neuen URL ist erforderlich
+- Wenn ein MCP-bereitgestelltes Web-Fetch-Tool verfügbar ist, dieses bevorzugt verwenden
+
+## Bedeutung in cc-viewer
+
+WebFetch-Aufrufe erscheinen im Anfrage-Log als `tool_use` / `tool_result` Content-Block-Paare. `tool_result` enthält die KI-verarbeitete Zusammenfassung des Webseiteninhalts.

package/concepts/de/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Definition
+
+Führt eine Suchmaschinenabfrage durch und gibt Suchergebnisse zurück, um aktuelle Informationen zu erhalten.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `query` | string | Ja | Suchanfrage (mindestens 2 Zeichen) |
+| `allowed_domains` | string[] | Nein | Nur Ergebnisse von diesen Domains einschließen |
+| `blocked_domains` | string[] | Nein | Ergebnisse von diesen Domains ausschließen |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Aktuelle Informationen abrufen, die über den Wissensstand des Modells hinausgehen
+- Aktuelle Ereignisse und neueste Daten finden
+- Neueste technische Dokumentation suchen
+
+## Hinweise
+
+- Suchergebnisse werden im Markdown-Hyperlink-Format zurückgegeben
+- Nach der Verwendung muss am Ende der Antwort ein "Sources:"-Abschnitt mit den relevanten URLs angefügt werden
+- Unterstützt Domain-Filterung (einschließen/ausschließen)
+- In Suchanfragen sollte das aktuelle Jahr verwendet werden
+- Nur in den USA verfügbar
+
+## Bedeutung in cc-viewer
+
+WebSearch-Aufrufe erscheinen im Anfrage-Log als `tool_use` / `tool_result` Content-Block-Paare. `tool_result` enthält die Liste der Suchergebnisse.

package/concepts/de/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Definition
+
+Schreibt Inhalte in das lokale Dateisystem. Überschreibt die Datei, falls sie bereits existiert.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `file_path` | string | Ja | Absoluter Pfad der Datei (muss ein absoluter Pfad sein) |
+| `content` | string | Ja | Der zu schreibende Inhalt |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Neue Dateien erstellen
+- Wenn der Dateiinhalt vollständig neu geschrieben werden muss
+
+**Nicht geeignet für:**
+- Teilinhalte einer Datei ändern – dafür Edit verwenden
+- Nicht proaktiv Dokumentationsdateien (*.md) oder READMEs erstellen, es sei denn, der Benutzer fordert es ausdrücklich an
+
+## Hinweise
+
+- Wenn die Zieldatei bereits existiert, muss sie zuerst über Read gelesen werden, sonst schlägt der Vorgang fehl
+- Überschreibt den gesamten Inhalt einer vorhandenen Datei
+- Edit zum Bearbeiten vorhandener Dateien bevorzugen; Write nur für neue Dateien oder vollständige Neuschreibungen verwenden
+
+## Bedeutung in cc-viewer
+
+Write-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block, dessen `input.content` den vollständigen geschriebenen Inhalt enthält.

package/concepts/de/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## Definition
+
+Führt Python-Code im Jupyter-Kernel der aktuellen Notebook-Datei aus.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `code` | string | Ja | Der auszuführende Python-Code |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Code in einer Jupyter-Notebook-Umgebung ausführen
+- Code-Snippets testen
+- Datenanalyse und Berechnungen
+
+**Nicht geeignet für:**
+- Codeausführung außerhalb von Jupyter – dafür Bash verwenden
+- Dateien ändern – dafür Edit oder Write verwenden
+
+## Hinweise
+
+- Dies ist ein MCP-Tool (Model Context Protocol), bereitgestellt durch die IDE-Integration
+- Code wird im aktuellen Jupyter-Kernel ausgeführt, der Zustand bleibt zwischen Aufrufen bestehen
+- Sofern der Benutzer es nicht ausdrücklich anfordert, sollte das Deklarieren von Variablen oder Ändern des Kernel-Zustands vermieden werden
+- Nach einem Kernel-Neustart geht der Zustand verloren
+
+## Bedeutung in cc-viewer
+
+executeCode ist ein MCP-Tool und erscheint im `tools`-Array des Anfrage-Logs unter dem Namen `mcp__ide__executeCode`. Aufrufe und Rückgaben folgen dem Standard-`tool_use` / `tool_result`-Muster. Änderungen an MCP-Tools führen zu Änderungen im tools-Array und können einen Cache-Neuaufbau auslösen.