cc-viewer 1.3.0 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/concepts/ar/Tool-Agent.md +55 -0
  2. package/concepts/ar/Tool-Task.md +2 -0
  3. package/concepts/da/Tool-Agent.md +55 -0
  4. package/concepts/da/Tool-Task.md +2 -0
  5. package/concepts/de/Tool-Agent.md +55 -0
  6. package/concepts/de/Tool-Task.md +2 -0
  7. package/concepts/en/Tool-Agent.md +55 -0
  8. package/concepts/en/Tool-Task.md +2 -0
  9. package/concepts/es/Tool-Agent.md +55 -0
  10. package/concepts/es/Tool-Task.md +2 -0
  11. package/concepts/fr/Tool-Agent.md +55 -0
  12. package/concepts/fr/Tool-Task.md +2 -0
  13. package/concepts/it/Tool-Agent.md +55 -0
  14. package/concepts/it/Tool-Task.md +2 -0
  15. package/concepts/ja/Tool-Agent.md +55 -0
  16. package/concepts/ja/Tool-Task.md +2 -0
  17. package/concepts/ko/Tool-Agent.md +55 -0
  18. package/concepts/ko/Tool-Task.md +2 -0
  19. package/concepts/no/Tool-Agent.md +55 -0
  20. package/concepts/no/Tool-Task.md +2 -0
  21. package/concepts/pl/Tool-Agent.md +55 -0
  22. package/concepts/pl/Tool-Task.md +2 -0
  23. package/concepts/pt-BR/Tool-Agent.md +55 -0
  24. package/concepts/pt-BR/Tool-Task.md +2 -0
  25. package/concepts/ru/Tool-Agent.md +55 -0
  26. package/concepts/ru/Tool-Task.md +2 -0
  27. package/concepts/th/Tool-Agent.md +55 -0
  28. package/concepts/th/Tool-Task.md +2 -0
  29. package/concepts/tr/Tool-Agent.md +55 -0
  30. package/concepts/tr/Tool-Task.md +2 -0
  31. package/concepts/uk/Tool-Agent.md +55 -0
  32. package/concepts/uk/Tool-Task.md +2 -0
  33. package/concepts/zh/Tool-Agent.md +55 -0
  34. package/concepts/zh/Tool-Task.md +2 -0
  35. package/concepts/zh-TW/Tool-Agent.md +55 -0
  36. package/concepts/zh-TW/Tool-Task.md +2 -0
  37. package/dist/assets/{index-C8W8UYGw.js → index-DAPmWK2v.js} +94 -94
  38. package/dist/assets/{index-V2-sKBoM.css → index-Dsn6K9v-.css} +1 -1
  39. package/dist/index.html +2 -2
  40. package/interceptor.js +2 -1
  41. package/package.json +2 -1
  42. package/stats-worker.js +236 -0
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## التعريف
4
+
5
+ بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات بشكل مستقل. الوكلاء الفرعيون هم عمليات فرعية مستقلة، لكل منها مجموعة أدوات وسياق مخصص. Agent هو النسخة المعاد تسميتها من أداة Task في الإصدارات الأحدث من Claude Code.
6
+
7
+ ## المعاملات
8
+
9
+ | المعامل | النوع | مطلوب | الوصف |
10
+ |---------|-------|-------|-------|
11
+ | `prompt` | string | نعم | وصف المهمة التي سينفذها الوكيل الفرعي |
12
+ | `description` | string | نعم | ملخص مختصر من 3-5 كلمات |
13
+ | `subagent_type` | string | نعم | نوع الوكيل الفرعي، يحدد مجموعة الأدوات المتاحة |
14
+ | `model` | enum | لا | تحديد النموذج (sonnet / opus / haiku)، الافتراضي يرث من الأصل |
15
+ | `max_turns` | integer | لا | الحد الأقصى لعدد الجولات |
16
+ | `run_in_background` | boolean | لا | هل يعمل في الخلفية، المهام الخلفية تُرجع مسار output_file |
17
+ | `resume` | string | لا | معرف الوكيل المراد استئنافه، يستمر من آخر تنفيذ. مفيد لاستئناف وكيل فرعي سابق دون فقدان السياق |
18
+ | `isolation` | enum | لا | وضع العزل، `worktree` ينشئ git worktree مؤقت |
19
+
20
+ ## أنواع الوكلاء الفرعيين
21
+
22
+ | النوع | الغرض | الأدوات المتاحة |
23
+ |-------|--------|----------------|
24
+ | `Bash` | تنفيذ الأوامر، عمليات git | Bash |
25
+ | `general-purpose` | مهام عامة متعددة الخطوات | جميع الأدوات |
26
+ | `Explore` | استكشاف سريع لقاعدة الكود | جميع الأدوات باستثناء Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | تصميم خطط التنفيذ | جميع الأدوات باستثناء Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | أسئلة وأجوبة حول دليل استخدام Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | تكوين شريط الحالة | Read, Edit |
30
+
31
+ ## سيناريوهات الاستخدام
32
+
33
+ **مناسب للاستخدام:**
34
+ - المهام المعقدة التي تتطلب إنجازاً مستقلاً متعدد الخطوات
35
+ - استكشاف قاعدة الكود والبحث المعمق (باستخدام نوع Explore)
36
+ - العمل المتوازي الذي يتطلب بيئة معزولة
37
+ - المهام طويلة المدة التي تحتاج للعمل في الخلفية
38
+
39
+ **غير مناسب للاستخدام:**
40
+ - قراءة مسار ملف محدد — استخدم Read أو Glob مباشرة
41
+ - البحث في 2-3 ملفات معروفة — استخدم Read مباشرة
42
+ - البحث عن تعريف فئة محددة — استخدم Glob مباشرة
43
+
44
+ ## ملاحظات
45
+
46
+ - بعد اكتمال الوكيل الفرعي يُرجع رسالة واحدة، نتائجه غير مرئية للمستخدم ويحتاج الوكيل الرئيسي لنقلها
47
+ - يمكن إطلاق عدة استدعاءات Agent بالتوازي في رسالة واحدة لزيادة الكفاءة
48
+ - يتم فحص تقدم المهام الخلفية عبر أداة TaskOutput
49
+ - نوع Explore أبطأ من استدعاء Glob/Grep مباشرة، يُستخدم فقط عندما لا يكفي البحث البسيط
50
+ - استخدم `run_in_background: true` للمهام طويلة المدة التي لا تحتاج نتائج فورية؛ استخدم الوضع الأمامي (الافتراضي) عندما تكون النتيجة مطلوبة قبل المتابعة
51
+ - يتيح معامل `resume` استئناف جلسة وكيل فرعي بدأت سابقاً مع الحفاظ على السياق المتراكم
52
+
53
+ ## الأهمية في cc-viewer
54
+
55
+ Agent هو الاسم الجديد لأداة Task في الإصدارات الأخيرة من Claude Code. ينتج استدعاء Agent سلسلة طلبات SubAgent، يمكن رؤية تسلسل طلبات فرعية مستقلة عن MainAgent في قائمة الطلبات. عادة ما تتميز طلبات SubAgent بـ system prompt مختصر وتعريفات أدوات أقل، مما يشكل تبايناً واضحاً مع MainAgent. في cc-viewer، قد يظهر اسم الأداة `Task` أو `Agent` حسب إصدار Claude Code المستخدم في المحادثة المسجلة.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **ملاحظة:** في الإصدارات الأحدث من Claude Code، تمت إعادة تسمية هذه الأداة إلى **Agent**. راجع مستند [Tool-Agent](Tool-Agent).
4
+
3
5
  ## التعريف
4
6
 
5
7
  بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات بشكل مستقل. الوكلاء الفرعيون هم عمليات فرعية مستقلة، لكل منها مجموعة أدوات وسياق مخصص.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Definition
4
+
5
+ Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst. Agent er den omdøbte version af Task-værktøjet i nyere Claude Code-versioner.
6
+
7
+ ## Parametre
8
+
9
+ | Parameter | Type | Påkrævet | Beskrivelse |
10
+ |------|------|------|------|
11
+ | `prompt` | string | Ja | Beskrivelse af opgaven sub-agenten skal udføre |
12
+ | `description` | string | Ja | Kort resumé på 3-5 ord |
13
+ | `subagent_type` | string | Ja | Sub-agent-type, bestemmer det tilgængelige værktøjssæt |
14
+ | `model` | enum | Nej | Angiv model (sonnet / opus / haiku), standard arvet fra forælder |
15
+ | `max_turns` | integer | Nej | Maksimalt antal agentiske ture |
16
+ | `run_in_background` | boolean | Nej | Om den skal køre i baggrunden; baggrundsopgaver returnerer output_file-sti |
17
+ | `resume` | string | Nej | Agent-ID der skal genoptages, fortsætter fra sidste udførelse. Nyttigt til at genoptage en tidligere sub-agent uden at miste kontekst |
18
+ | `isolation` | enum | Nej | Isoleringstilstand, `worktree` opretter et midlertidigt git worktree |
19
+
20
+ ## Sub-agent-typer
21
+
22
+ | Type | Formål | Tilgængelige værktøjer |
23
+ |------|------|----------|
24
+ | `Bash` | Kommandoudførelse, git-operationer | Bash |
25
+ | `general-purpose` | Generelle flertrinsopgaver | Alle værktøjer |
26
+ | `Explore` | Hurtig udforskning af kodebasen | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Design af implementeringsplan | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Q&A om Claude Code-brugsvejledning | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Konfiguration af statuslinje | Read, Edit |
30
+
31
+ ## Brugsscenarier
32
+
33
+ **Egnet til:**
34
+ - Komplekse opgaver der kræver selvstændig fuldførelse i flere trin
35
+ - Udforskning af kodebasen og dybdegående research (brug Explore-type)
36
+ - Parallelt arbejde der kræver isolerede miljøer
37
+ - Langvarige opgaver der skal køre i baggrunden
38
+
39
+ **Ikke egnet til:**
40
+ - Læse en specifik filsti — brug direkte Read eller Glob
41
+ - Søge i 2-3 kendte filer — brug direkte Read
42
+ - Søge efter en specifik klassedefinition — brug direkte Glob
43
+
44
+ ## Bemærkninger
45
+
46
+ - Ved fuldførelse returnerer sub-agenten en enkelt besked; dens resultat er ikke synligt for brugeren og skal videreformidles af hovedagenten
47
+ - Man kan starte flere parallelle Agent-kald i en enkelt besked for at øge effektiviteten
48
+ - Baggrundsopgaver overvåges via TaskOutput-værktøjet
49
+ - Explore-typen er langsommere end direkte Glob/Grep-kald, brug den kun når simpel søgning ikke er tilstrækkelig
50
+ - Brug `run_in_background: true` til langvarige opgaver der ikke kræver øjeblikkeligt resultat; brug forgrundstilstand (standard) når resultatet er nødvendigt før man fortsætter
51
+ - `resume`-parameteren gør det muligt at fortsætte en tidligere startet sub-agent-session og bevare den akkumulerede kontekst
52
+
53
+ ## Betydning i cc-viewer
54
+
55
+ Agent er det nye navn for Task-værktøjet i nyere Claude Code-versioner. Agent-kald genererer SubAgent-requestkæder, der i requestlisten kan ses som uafhængige underrequestsekvenser adskilt fra MainAgent. SubAgent-requests har typisk et forenklet system prompt og færre værktøjsdefinitioner, i tydelig kontrast til MainAgent. I cc-viewer kan værktøjsnavnene `Task` eller `Agent` forekomme afhængigt af den Claude Code-version der blev brugt i den optagede samtale.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Bemærk:** I nyere versioner af Claude Code er dette værktøj omdøbt til **Agent**. Se dokumentet [Tool-Agent](Tool-Agent).
4
+
3
5
  ## Definition
4
6
 
5
7
  Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Definition
4
+
5
+ Startet einen Sub-Agent (SubAgent), der komplexe mehrstufige Aufgaben autonom bearbeitet. Sub-Agents sind unabhängige Unterprozesse mit jeweils eigenen Tool-Sets und Kontext. Agent ist die umbenannte Version des Task-Tools in neueren Claude Code-Versionen.
6
+
7
+ ## Parameter
8
+
9
+ | Parameter | Typ | Erforderlich | Beschreibung |
10
+ |-----------|-----|--------------|--------------|
11
+ | `prompt` | string | Ja | Aufgabenbeschreibung für den Sub-Agent |
12
+ | `description` | string | Ja | Kurze Zusammenfassung in 3–5 Wörtern |
13
+ | `subagent_type` | string | Ja | Sub-Agent-Typ, bestimmt das verfügbare Tool-Set |
14
+ | `model` | enum | Nein | Modell angeben (sonnet / opus / haiku), Standard wird vom übergeordneten Agent geerbt |
15
+ | `max_turns` | integer | Nein | Maximale Anzahl agentischer Runden |
16
+ | `run_in_background` | boolean | Nein | Ob im Hintergrund ausgeführt werden soll; Hintergrundaufgaben geben den output_file-Pfad zurück |
17
+ | `resume` | string | Nein | Agent-ID zum Fortsetzen, setzt die letzte Ausführung fort. Nützlich, um einen vorherigen Sub-Agent ohne Kontextverlust fortzusetzen |
18
+ | `isolation` | enum | Nein | Isolationsmodus, `worktree` erstellt einen temporären Git-Worktree |
19
+
20
+ ## Sub-Agent-Typen
21
+
22
+ | Typ | Zweck | Verfügbare Tools |
23
+ |-----|-------|------------------|
24
+ | `Bash` | Befehlsausführung, Git-Operationen | Bash |
25
+ | `general-purpose` | Allgemeine mehrstufige Aufgaben | Alle Tools |
26
+ | `Explore` | Schnelle Codebasis-Erkundung | Alle Tools außer Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Implementierungsplan entwerfen | Alle Tools außer Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Claude Code Nutzungsanleitung Q&A | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Statusleiste konfigurieren | Read, Edit |
30
+
31
+ ## Anwendungsfälle
32
+
33
+ **Geeignet für:**
34
+ - Komplexe Aufgaben, die mehrere autonome Schritte erfordern
35
+ - Codebasis-Erkundung und Tiefenrecherche (Explore-Typ verwenden)
36
+ - Parallele Arbeit, die eine isolierte Umgebung erfordert
37
+ - Lang laufende Aufgaben, die im Hintergrund ausgeführt werden müssen
38
+
39
+ **Nicht geeignet für:**
40
+ - Bestimmte Dateipfade lesen – direkt Read oder Glob verwenden
41
+ - In 2–3 bekannten Dateien suchen – direkt Read verwenden
42
+ - Bestimmte Klassendefinitionen suchen – direkt Glob verwenden
43
+
44
+ ## Hinweise
45
+
46
+ - 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
47
+ - Mehrere parallele Agent-Aufrufe können in einer einzelnen Nachricht gestartet werden, um die Effizienz zu steigern
48
+ - Hintergrundaufgaben werden über das TaskOutput-Tool auf Fortschritt geprüft
49
+ - Der Explore-Typ ist langsamer als direkte Glob/Grep-Aufrufe; nur verwenden, wenn einfache Suchen nicht ausreichen
50
+ - Verwenden Sie `run_in_background: true` für lang laufende Aufgaben, die kein sofortiges Ergebnis benötigen; verwenden Sie den Vordergrundmodus (Standard), wenn das Ergebnis vor dem Fortfahren benötigt wird
51
+ - Der `resume`-Parameter ermöglicht die Fortsetzung einer zuvor gestarteten Sub-Agent-Sitzung unter Beibehaltung des angesammelten Kontexts
52
+
53
+ ## Bedeutung in cc-viewer
54
+
55
+ Agent ist der neue Name des Task-Tools in neueren Claude Code-Versionen. Agent-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. In cc-viewer können je nach verwendeter Claude Code-Version in der aufgezeichneten Konversation die Tool-Namen `Task` oder `Agent` erscheinen.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Hinweis:** In neueren Claude Code-Versionen wurde dieses Tool in **Agent** umbenannt. Siehe das [Tool-Agent](Tool-Agent)-Dokument.
4
+
3
5
  ## Definition
4
6
 
5
7
  Startet einen Sub-Agent (SubAgent), der komplexe mehrstufige Aufgaben autonom bearbeitet. Sub-Agents sind unabhängige Unterprozesse mit jeweils eigenen Tool-Sets und Kontext.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Definition
4
+
5
+ Launches a SubAgent to autonomously handle complex multi-step tasks. SubAgents are independent subprocesses, each with their own dedicated tool set and context. Agent is the renamed version of the Task tool in newer Claude Code releases.
6
+
7
+ ## Parameters
8
+
9
+ | Parameter | Type | Required | Description |
10
+ |-----------|------|----------|-------------|
11
+ | `prompt` | string | Yes | Description of the task for the SubAgent to execute |
12
+ | `description` | string | Yes | A 3-5 word short summary |
13
+ | `subagent_type` | string | Yes | SubAgent type, determines the available tool set |
14
+ | `model` | enum | No | Specify model (sonnet / opus / haiku), defaults to inheriting from parent |
15
+ | `max_turns` | integer | No | Maximum number of agentic turns |
16
+ | `run_in_background` | boolean | No | Whether to run in the background; background tasks return an output_file path |
17
+ | `resume` | string | No | Agent ID to resume, continues from the last execution. Useful for picking up where a previous SubAgent left off without losing context |
18
+ | `isolation` | enum | No | Isolation mode, `worktree` creates a temporary git worktree |
19
+
20
+ ## SubAgent Types
21
+
22
+ | Type | Purpose | Available Tools |
23
+ |------|---------|-----------------|
24
+ | `Bash` | Command execution, git operations | Bash |
25
+ | `general-purpose` | General multi-step tasks | All tools |
26
+ | `Explore` | Quick codebase exploration | All tools except Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Design implementation plans | All tools except Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Claude Code usage guide Q&A | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Configure status bar | Read, Edit |
30
+
31
+ ## Use Cases
32
+
33
+ **Good for:**
34
+ - Complex tasks requiring multi-step autonomous completion
35
+ - Codebase exploration and deep research (using Explore type)
36
+ - Parallel work requiring isolated environments
37
+ - Long-running tasks that need to run in the background
38
+
39
+ **Not good for:**
40
+ - Reading a specific file path — use Read or Glob directly
41
+ - Searching within 2-3 known files — use Read directly
42
+ - Searching for a specific class definition — use Glob directly
43
+
44
+ ## Notes
45
+
46
+ - After completion, the SubAgent returns a single message; its results are not visible to the user and need to be relayed by the main agent
47
+ - Multiple Agent calls can be issued in parallel within a single message for efficiency
48
+ - Background tasks are checked for progress via the TaskOutput tool
49
+ - The Explore type is slower than directly calling Glob/Grep; only use it when simple searches are insufficient
50
+ - Use `run_in_background: true` for long-running tasks that don't need immediate results; use foreground (default) when the main agent needs the result before proceeding
51
+ - The `resume` parameter allows continuing a previously started SubAgent session, preserving its accumulated context
52
+
53
+ ## Significance in cc-viewer
54
+
55
+ Agent is the new name for the Task tool in recent Claude Code versions. Agent calls produce SubAgent request chains, which appear in the request list as sub-request sequences independent of MainAgent. SubAgent requests typically have streamlined system prompts and fewer tool definitions, forming a clear contrast with MainAgent. In cc-viewer, both `Task` and `Agent` tool names may appear depending on the Claude Code version used in the recorded conversation.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Note:** In newer versions of Claude Code, this tool has been renamed to **Agent**. See the [Tool-Agent](Tool-Agent) document.
4
+
3
5
  ## Definition
4
6
 
5
7
  Launches a SubAgent to autonomously handle complex multi-step tasks. SubAgents are independent subprocesses, each with their own dedicated tool set and context.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Definición
4
+
5
+ Inicia un sub-agent (SubAgent) para manejar de forma autónoma tareas complejas de múltiples pasos. Los sub-agents son subprocesos independientes, cada uno con su propio conjunto de herramientas y contexto dedicados. Agent es la versión renombrada de la herramienta Task en las versiones más recientes de Claude Code.
6
+
7
+ ## Parámetros
8
+
9
+ | Parámetro | Tipo | Requerido | Descripción |
10
+ |-----------|------|-----------|-------------|
11
+ | `prompt` | string | Sí | Descripción de la tarea a ejecutar por el sub-agent |
12
+ | `description` | string | Sí | Resumen breve de 3-5 palabras |
13
+ | `subagent_type` | string | Sí | Tipo de sub-agent, determina el conjunto de herramientas disponibles |
14
+ | `model` | enum | No | Especificar modelo (sonnet / opus / haiku), por defecto hereda del padre |
15
+ | `max_turns` | integer | No | Número máximo de turnos agénticos |
16
+ | `run_in_background` | boolean | No | Si se ejecuta en segundo plano; las tareas en segundo plano devuelven la ruta del output_file |
17
+ | `resume` | string | No | ID del agent a reanudar, continúa desde la última ejecución. Útil para retomar un sub-agent anterior sin perder el contexto |
18
+ | `isolation` | enum | No | Modo de aislamiento, `worktree` crea un git worktree temporal |
19
+
20
+ ## Tipos de sub-agent
21
+
22
+ | Tipo | Propósito | Herramientas disponibles |
23
+ |------|-----------|--------------------------|
24
+ | `Bash` | Ejecución de comandos, operaciones git | Bash |
25
+ | `general-purpose` | Tareas generales de múltiples pasos | Todas las herramientas |
26
+ | `Explore` | Exploración rápida de la base de código | Todas las herramientas excepto Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Diseñar planes de implementación | Todas las herramientas excepto Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Preguntas y respuestas sobre la guía de uso de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Configurar la barra de estado | Read, Edit |
30
+
31
+ ## Casos de uso
32
+
33
+ **Adecuado para:**
34
+ - Tareas complejas que requieren completarse de forma autónoma en múltiples pasos
35
+ - Exploración de la base de código e investigación profunda (usar tipo Explore)
36
+ - Trabajo paralelo que necesita entornos aislados
37
+ - Tareas de larga duración que necesitan ejecutarse en segundo plano
38
+
39
+ **No adecuado para:**
40
+ - Leer rutas de archivos específicas — usar directamente Read o Glob
41
+ - Buscar en 2-3 archivos conocidos — usar directamente Read
42
+ - Buscar definiciones de clases específicas — usar directamente Glob
43
+
44
+ ## Notas
45
+
46
+ - El sub-agent devuelve un solo mensaje al completarse, sus resultados no son visibles para el usuario y el agent principal necesita transmitirlos
47
+ - Se pueden lanzar múltiples llamadas Agent en paralelo en un solo mensaje para mejorar la eficiencia
48
+ - Las tareas en segundo plano verifican el progreso mediante la herramienta TaskOutput
49
+ - El tipo Explore es más lento que llamar directamente a Glob/Grep, usar solo cuando la búsqueda simple no es suficiente
50
+ - Use `run_in_background: true` para tareas de larga duración que no necesitan resultados inmediatos; use el modo en primer plano (predeterminado) cuando se necesita el resultado antes de continuar
51
+ - El parámetro `resume` permite continuar una sesión de sub-agent iniciada previamente, preservando el contexto acumulado
52
+
53
+ ## Significado en cc-viewer
54
+
55
+ Agent es el nuevo nombre de la herramienta Task en las versiones recientes de Claude Code. Las llamadas a Agent producen cadenas de solicitudes SubAgent, visibles en la lista de solicitudes como secuencias de sub-solicitudes independientes del MainAgent. Las solicitudes SubAgent generalmente tienen un system prompt simplificado y menos definiciones de herramientas, formando un contraste claro con el MainAgent. En cc-viewer, pueden aparecer los nombres de herramienta `Task` o `Agent` según la versión de Claude Code utilizada en la conversación grabada.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Nota:** En las versiones más recientes de Claude Code, esta herramienta ha sido renombrada a **Agent**. Consulte el documento [Tool-Agent](Tool-Agent).
4
+
3
5
  ## Definición
4
6
 
5
7
  Inicia un sub-agent (SubAgent) para manejar de forma autónoma tareas complejas de múltiples pasos. Los sub-agents son subprocesos independientes, cada uno con su propio conjunto de herramientas y contexto dedicados.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Définition
4
+
5
+ Lance un sous-agent (SubAgent) pour gérer de manière autonome des tâches complexes multi-étapes. Les sous-agents sont des sous-processus indépendants, chacun avec son propre ensemble d'outils et contexte dédiés. Agent est la version renommée de l'outil Task dans les nouvelles versions de Claude Code.
6
+
7
+ ## Paramètres
8
+
9
+ | Paramètre | Type | Requis | Description |
10
+ |-----------|------|--------|-------------|
11
+ | `prompt` | string | Oui | Description de la tâche à exécuter par le sous-agent |
12
+ | `description` | string | Oui | Résumé bref de 3-5 mots |
13
+ | `subagent_type` | string | Oui | Type de sous-agent, détermine l'ensemble d'outils disponibles |
14
+ | `model` | enum | Non | Spécifier le modèle (sonnet / opus / haiku), par défaut hérité du parent |
15
+ | `max_turns` | integer | Non | Nombre maximum de tours agentiques |
16
+ | `run_in_background` | boolean | Non | Si la tâche s'exécute en arrière-plan ; les tâches en arrière-plan renvoient le chemin du output_file |
17
+ | `resume` | string | Non | ID de l'agent à reprendre, continue depuis la dernière exécution. Utile pour reprendre un sous-agent précédent sans perdre le contexte |
18
+ | `isolation` | enum | Non | Mode d'isolation, `worktree` crée un git worktree temporaire |
19
+
20
+ ## Types de sous-agents
21
+
22
+ | Type | Utilité | Outils disponibles |
23
+ |------|---------|-------------------|
24
+ | `Bash` | Exécution de commandes, opérations git | Bash |
25
+ | `general-purpose` | Tâches générales multi-étapes | Tous les outils |
26
+ | `Explore` | Exploration rapide de la base de code | Tous les outils sauf Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Concevoir des plans d'implémentation | Tous les outils sauf Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Questions-réponses sur le guide d'utilisation de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Configurer la barre d'état | Read, Edit |
30
+
31
+ ## Cas d'utilisation
32
+
33
+ **Adapté pour :**
34
+ - Tâches complexes nécessitant une réalisation autonome en plusieurs étapes
35
+ - Exploration de la base de code et recherche approfondie (utiliser le type Explore)
36
+ - Travail parallèle nécessitant des environnements isolés
37
+ - Tâches de longue durée nécessitant une exécution en arrière-plan
38
+
39
+ **Non adapté pour :**
40
+ - Lire des chemins de fichiers spécifiques — utiliser directement Read ou Glob
41
+ - Rechercher dans 2-3 fichiers connus — utiliser directement Read
42
+ - Rechercher des définitions de classes spécifiques — utiliser directement Glob
43
+
44
+ ## Notes
45
+
46
+ - Le sous-agent renvoie un seul message à la fin, ses résultats ne sont pas visibles pour l'utilisateur et l'agent principal doit les transmettre
47
+ - Plusieurs appels Agent peuvent être lancés en parallèle dans un seul message pour améliorer l'efficacité
48
+ - Les tâches en arrière-plan vérifient la progression via l'outil TaskOutput
49
+ - Le type Explore est plus lent que l'appel direct à Glob/Grep, à utiliser uniquement quand la recherche simple ne suffit pas
50
+ - Utilisez `run_in_background: true` pour les tâches longues ne nécessitant pas de résultat immédiat ; utilisez le mode premier plan (par défaut) quand le résultat est nécessaire avant de continuer
51
+ - Le paramètre `resume` permet de continuer une session de sous-agent précédemment démarrée, en préservant le contexte accumulé
52
+
53
+ ## Signification dans cc-viewer
54
+
55
+ Agent est le nouveau nom de l'outil Task dans les versions récentes de Claude Code. Les appels Agent produisent des chaînes de requêtes SubAgent, visibles dans la liste des requêtes comme des séquences de sous-requêtes indépendantes du MainAgent. Les requêtes SubAgent ont généralement un system prompt simplifié et moins de définitions d'outils, formant un contraste net avec le MainAgent. Dans cc-viewer, les noms d'outils `Task` ou `Agent` peuvent apparaître selon la version de Claude Code utilisée dans la conversation enregistrée.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Note :** Dans les versions récentes de Claude Code, cet outil a été renommé en **Agent**. Voir le document [Tool-Agent](Tool-Agent).
4
+
3
5
  ## Définition
4
6
 
5
7
  Lance un sous-agent (SubAgent) pour gérer de manière autonome des tâches complexes multi-étapes. Les sous-agents sont des sous-processus indépendants, chacun avec son propre ensemble d'outils et contexte dédiés.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## Definizione
4
+
5
+ Avvia un sub agent (SubAgent) per gestire autonomamente task complessi multi-step. I sub agent sono sottoprocessi indipendenti, ciascuno con il proprio set di strumenti e contesto dedicati. Agent è la versione rinominata dello strumento Task nelle versioni più recenti di Claude Code.
6
+
7
+ ## Parametri
8
+
9
+ | Parametro | Tipo | Obbligatorio | Descrizione |
10
+ |------|------|------|------|
11
+ | `prompt` | string | Sì | Descrizione del task da eseguire per il sub agent |
12
+ | `description` | string | Sì | Breve riepilogo di 3-5 parole |
13
+ | `subagent_type` | string | Sì | Tipo di sub agent, determina il set di strumenti disponibili |
14
+ | `model` | enum | No | Specifica il modello (sonnet / opus / haiku), predefinito ereditato dal padre |
15
+ | `max_turns` | integer | No | Numero massimo di turni agentici |
16
+ | `run_in_background` | boolean | No | Se eseguire in background; i task in background restituiscono il percorso output_file |
17
+ | `resume` | string | No | ID dell'agent da riprendere, continua dall'ultima esecuzione. Utile per riprendere un sub agent precedente senza perdere il contesto |
18
+ | `isolation` | enum | No | Modalità di isolamento, `worktree` crea un git worktree temporaneo |
19
+
20
+ ## Tipi di sub agent
21
+
22
+ | Tipo | Scopo | Strumenti disponibili |
23
+ |------|------|----------|
24
+ | `Bash` | Esecuzione comandi, operazioni git | Bash |
25
+ | `general-purpose` | Task multi-step generici | Tutti gli strumenti |
26
+ | `Explore` | Esplorazione rapida del codebase | Tutti gli strumenti tranne Agent/Edit/Write/NotebookEdit/ExitPlanMode |
27
+ | `Plan` | Progettazione del piano di implementazione | Tutti gli strumenti tranne Agent/Edit/Write/NotebookEdit/ExitPlanMode |
28
+ | `claude-code-guide` | Q&A sulla guida all'uso di Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | Configurazione della barra di stato | Read, Edit |
30
+
31
+ ## Scenari d'uso
32
+
33
+ **Adatto per:**
34
+ - Task complessi che richiedono il completamento autonomo in più step
35
+ - Esplorazione del codebase e ricerca approfondita (usando il tipo Explore)
36
+ - Lavoro parallelo che richiede ambienti isolati
37
+ - Task a lunga esecuzione che devono essere eseguiti in background
38
+
39
+ **Non adatto per:**
40
+ - Leggere un percorso file specifico — usare direttamente Read o Glob
41
+ - Cercare in 2-3 file noti — usare direttamente Read
42
+ - Cercare una definizione di classe specifica — usare direttamente Glob
43
+
44
+ ## Note
45
+
46
+ - Al completamento, il sub agent restituisce un singolo messaggio; il suo risultato non è visibile all'utente e deve essere riportato dall'agent principale
47
+ - È possibile lanciare più chiamate Agent in parallelo in un singolo messaggio per migliorare l'efficienza
48
+ - I task in background vengono monitorati tramite lo strumento TaskOutput
49
+ - Il tipo Explore è più lento delle chiamate dirette a Glob/Grep, usarlo solo quando la ricerca semplice non è sufficiente
50
+ - Usare `run_in_background: true` per task a lunga esecuzione che non necessitano di risultati immediati; usare la modalità in primo piano (predefinita) quando il risultato è necessario prima di procedere
51
+ - Il parametro `resume` consente di continuare una sessione di sub agent avviata in precedenza, preservando il contesto accumulato
52
+
53
+ ## Significato in cc-viewer
54
+
55
+ Agent è il nuovo nome dello strumento Task nelle versioni recenti di Claude Code. Le chiamate Agent generano catene di richieste SubAgent, visibili nella lista delle richieste come sequenze di sotto-richieste indipendenti dal MainAgent. Le richieste SubAgent hanno tipicamente un system prompt semplificato e meno definizioni di strumenti, in netto contrasto con il MainAgent. In cc-viewer, possono apparire i nomi strumento `Task` o `Agent` a seconda della versione di Claude Code utilizzata nella conversazione registrata.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **Nota:** Nelle versioni più recenti di Claude Code, questo strumento è stato rinominato in **Agent**. Vedere il documento [Tool-Agent](Tool-Agent).
4
+
3
5
  ## Definizione
4
6
 
5
7
  Avvia un sub agent (SubAgent) per gestire autonomamente task complessi multi-step. I sub agent sono sottoprocessi indipendenti, ciascuno con il proprio set di strumenti e contesto dedicati.
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## 定義
4
+
5
+ サブ agent(SubAgent)を起動して、複雑なマルチステップタスクを自律的に処理します。サブ agent は独立したサブプロセスで、それぞれ専用のツールセットとコンテキストを持ちます。Agent は新しい Claude Code バージョンにおける Task ツールのリネーム版です。
6
+
7
+ ## パラメータ
8
+
9
+ | パラメータ | 型 | 必須 | 説明 |
10
+ |------------|------|------|------|
11
+ | `prompt` | string | はい | サブ agent が実行するタスクの説明 |
12
+ | `description` | string | はい | 3〜5語の短い要約 |
13
+ | `subagent_type` | string | はい | サブ agent タイプ、利用可能なツールセットを決定 |
14
+ | `model` | enum | いいえ | モデルを指定(sonnet / opus / haiku)、デフォルトは親から継承 |
15
+ | `max_turns` | integer | いいえ | 最大 agentic ターン数 |
16
+ | `run_in_background` | boolean | いいえ | バックグラウンドで実行するかどうか。バックグラウンドタスクは output_file パスを返す |
17
+ | `resume` | string | いいえ | 再開する agent ID、前回の実行から続行。コンテキストを失わずに以前のサブ agent を引き継ぐのに有用 |
18
+ | `isolation` | enum | いいえ | 隔離モード、`worktree` で一時的な git worktree を作成 |
19
+
20
+ ## サブ agent タイプ
21
+
22
+ | タイプ | 用途 | 利用可能なツール |
23
+ |--------|------|------------------|
24
+ | `Bash` | コマンド実行、git 操作 | Bash |
25
+ | `general-purpose` | 汎用マルチステップタスク | 全ツール |
26
+ | `Explore` | コードベースの高速探索 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
27
+ | `Plan` | 実装方針の設計 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 以外のすべて |
28
+ | `claude-code-guide` | Claude Code 使用ガイド Q&A | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | ステータスバーの設定 | Read, Edit |
30
+
31
+ ## 使用シナリオ
32
+
33
+ **適している場合:**
34
+ - マルチステップで自律的に完了する必要がある複雑なタスク
35
+ - コードベースの探索と深い調査(Explore タイプを使用)
36
+ - 隔離環境が必要な並列作業
37
+ - バックグラウンドで実行する必要がある長時間タスク
38
+
39
+ **適していない場合:**
40
+ - 特定のファイルパスの読み取り——直接 Read または Glob を使用
41
+ - 2〜3個の既知ファイル内の検索——直接 Read を使用
42
+ - 特定のクラス定義の検索——直接 Glob を使用
43
+
44
+ ## 注意事項
45
+
46
+ - サブ agent は完了後に単一メッセージを返し、その結果はユーザーには見えないため、メイン agent が伝達する必要がある
47
+ - 単一メッセージ内で複数の並列 Agent 呼び出しを発行して効率を向上できる
48
+ - バックグラウンドタスクは TaskOutput ツールで進捗を確認
49
+ - Explore タイプは直接 Glob/Grep を呼び出すより遅いため、単純な検索では不十分な場合にのみ使用
50
+ - 長時間実行で即座に結果が不要なタスクには `run_in_background: true` を推奨。結果が必要な場合はフォアグラウンド(デフォルト)を使用
51
+ - `resume` パラメータにより、以前開始したサブ agent セッションを継続でき、蓄積されたコンテキストを保持
52
+
53
+ ## cc-viewer での意義
54
+
55
+ Agent は新しい Claude Code バージョンにおける Task ツールの新名称です。Agent 呼び出しは SubAgent リクエストチェーンを生成し、リクエストリストで MainAgent とは独立したサブリクエストシーケンスとして確認できます。SubAgent リクエストは通常、簡潔な system prompt と少ないツール定義を持ち、MainAgent と明確な対比を形成します。cc-viewer では、記録された会話で使用された Claude Code のバージョンに応じて、`Task` または `Agent` のいずれかのツール名が表示される場合があります。
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **注意:** 新しい Claude Code バージョンでは、このツールは **Agent** に名称変更されました。[Tool-Agent](Tool-Agent) ドキュメントを参照してください。
4
+
3
5
  ## 定義
4
6
 
5
7
  サブ agent(SubAgent)を起動して、複雑なマルチステップタスクを自律的に処理します。サブ agent は独立したサブプロセスで、それぞれ専用のツールセットとコンテキストを持ちます。
@@ -0,0 +1,55 @@
1
+ # Agent
2
+
3
+ ## 정의
4
+
5
+ 서브 agent (SubAgent)를 시작하여 복잡한 다단계 태스크를 자율적으로 처리합니다. 서브 agent는 독립된 서브프로세스로, 각각 전용 도구 세트와 컨텍스트를 가집니다. Agent는 최신 Claude Code 버전에서 Task 도구의 이름이 변경된 버전입니다.
6
+
7
+ ## 파라미터
8
+
9
+ | 파라미터 | 타입 | 필수 | 설명 |
10
+ |----------|------|------|------|
11
+ | `prompt` | string | 예 | 서브 agent가 실행할 태스크 설명 |
12
+ | `description` | string | 예 | 3~5단어의 짧은 요약 |
13
+ | `subagent_type` | string | 예 | 서브 agent 타입, 사용 가능한 도구 세트를 결정 |
14
+ | `model` | enum | 아니오 | 모델 지정 (sonnet / opus / haiku), 기본값은 부모로부터 상속 |
15
+ | `max_turns` | integer | 아니오 | 최대 agentic 턴 수 |
16
+ | `run_in_background` | boolean | 아니오 | 백그라운드 실행 여부. 백그라운드 태스크는 output_file 경로를 반환 |
17
+ | `resume` | string | 아니오 | 재개할 agent ID, 이전 실행에서 계속. 컨텍스트를 잃지 않고 이전 서브 agent를 이어받는 데 유용 |
18
+ | `isolation` | enum | 아니오 | 격리 모드, `worktree`로 임시 git worktree 생성 |
19
+
20
+ ## 서브 agent 타입
21
+
22
+ | 타입 | 용도 | 사용 가능한 도구 |
23
+ |------|------|------------------|
24
+ | `Bash` | 명령 실행, git 작업 | Bash |
25
+ | `general-purpose` | 범용 다단계 태스크 | 전체 도구 |
26
+ | `Explore` | 코드베이스 빠른 탐색 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
27
+ | `Plan` | 구현 방안 설계 | Agent/Edit/Write/NotebookEdit/ExitPlanMode 외 모든 도구 |
28
+ | `claude-code-guide` | Claude Code 사용 가이드 Q&A | Glob, Grep, Read, WebFetch, WebSearch |
29
+ | `statusline-setup` | 상태 표시줄 설정 | Read, Edit |
30
+
31
+ ## 사용 시나리오
32
+
33
+ **적합한 경우:**
34
+ - 다단계로 자율 완료해야 하는 복잡한 태스크
35
+ - 코드베이스 탐색 및 심층 조사 (Explore 타입 사용)
36
+ - 격리 환경이 필요한 병렬 작업
37
+ - 백그라운드 실행이 필요한 장시간 태스크
38
+
39
+ **적합하지 않은 경우:**
40
+ - 특정 파일 경로 읽기 — 직접 Read 또는 Glob 사용
41
+ - 2~3개 알려진 파일 내 검색 — 직접 Read 사용
42
+ - 특정 클래스 정의 검색 — 직접 Glob 사용
43
+
44
+ ## 주의사항
45
+
46
+ - 서브 agent는 완료 후 단일 메시지를 반환하며, 그 결과는 사용자에게 보이지 않으므로 메인 agent가 전달해야 함
47
+ - 단일 메시지 내에서 여러 병렬 Agent 호출을 발행하여 효율 향상 가능
48
+ - 백그라운드 태스크는 TaskOutput 도구로 진행 상황 확인
49
+ - Explore 타입은 직접 Glob/Grep 호출보다 느리므로, 단순 검색으로 충분하지 않을 때만 사용
50
+ - 장시간 실행되며 즉시 결과가 필요 없는 태스크에는 `run_in_background: true` 권장; 결과가 필요한 경우 포그라운드(기본값) 사용
51
+ - `resume` 파라미터를 통해 이전에 시작한 서브 agent 세션을 계속할 수 있으며, 축적된 컨텍스트를 유지
52
+
53
+ ## cc-viewer에서의 의의
54
+
55
+ Agent는 최신 Claude Code 버전에서 Task 도구의 새 이름입니다. Agent 호출은 SubAgent 요청 체인을 생성하며, 요청 목록에서 MainAgent와 독립된 서브 요청 시퀀스로 확인할 수 있습니다. SubAgent 요청은 보통 간결한 system prompt와 적은 도구 정의를 가지며, MainAgent와 뚜렷한 대비를 이룹니다. cc-viewer에서는 기록된 대화에서 사용된 Claude Code 버전에 따라 `Task` 또는 `Agent` 도구 이름이 표시될 수 있습니다.
@@ -1,5 +1,7 @@
1
1
  # Task
2
2
 
3
+ > **참고:** 최신 Claude Code 버전에서 이 도구는 **Agent**로 이름이 변경되었습니다. [Tool-Agent](Tool-Agent) 문서를 참조하세요.
4
+
3
5
  ## 정의
4
6
 
5
7
  서브 agent (SubAgent)를 시작하여 복잡한 다단계 태스크를 자율적으로 처리합니다. 서브 agent는 독립된 서브프로세스로, 각각 전용 도구 세트와 컨텍스트를 가집니다.