cc-viewer 1.2.0 → 1.2.2

package/concepts/fr/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Définition
+
+Bascule Claude Code en mode planification, utilisé pour explorer la base de code et concevoir un plan avant l'implémentation.
+
+## Paramètres
+
+Aucun paramètre.
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Implémentation de nouvelles fonctionnalités — nécessite des décisions d'architecture
+- Plusieurs approches viables existent — nécessite le choix de l'utilisateur
+- Les modifications de code affectent le comportement ou la structure existante
+- Changements dans plusieurs fichiers — impliquant potentiellement 2-3 fichiers ou plus
+- Exigences peu claires — besoin d'explorer d'abord pour comprendre la portée
+- Les préférences de l'utilisateur sont importantes — l'implémentation peut avoir plusieurs directions raisonnables
+
+**Non adapté pour :**
+- Corrections d'une ligne ou de quelques lignes (fautes de frappe, bugs évidents)
+- L'utilisateur a déjà donné des instructions très spécifiques
+- Tâches purement de recherche/exploration — utiliser Task (type Explore)
+
+## Comportement en mode planification
+
+Après être entré en mode planification, Claude Code :
+1. Utilise les outils Glob, Grep, Read pour explorer la base de code en profondeur
+2. Comprend les patterns et l'architecture existants
+3. Conçoit un plan d'implémentation
+4. Soumet le plan à l'utilisateur pour approbation
+5. Peut utiliser AskUserQuestion si des clarifications sont nécessaires
+6. Sort via ExitPlanMode lorsque le plan est prêt
+
+## Notes
+
+- Cet outil nécessite le consentement de l'utilisateur pour entrer en mode planification
+- En cas de doute sur la nécessité de planifier, il est préférable de planifier — s'aligner en amont est mieux que de refaire
+
+## Signification dans cc-viewer
+
+Les appels à EnterPlanMode apparaissent dans le journal des requêtes comme des content blocks `tool_use`. Après l'entrée en mode planification, la séquence de requêtes consiste généralement principalement en appels d'outils exploratoires (Glob, Grep, Read), jusqu'à ce que ExitPlanMode soit appelé.

package/concepts/fr/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Définition
+
+Quitte le mode planification et soumet le plan à l'utilisateur pour approbation. Le contenu du plan est lu à partir du fichier de plan écrit précédemment.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `allowedPrompts` | array | Non | Liste des descriptions de permissions nécessaires pour implémenter le plan |
+
+Chaque élément du tableau `allowedPrompts` :
+
+| Champ | Type | Requis | Description |
+|-------|------|--------|-------------|
+| `tool` | enum | Oui | Outil applicable, actuellement seul `Bash` est supporté |
+| `prompt` | string | Oui | Description sémantique de l'opération (comme « run tests », « install dependencies ») |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Le plan est terminé en mode planification, prêt à être soumis pour approbation de l'utilisateur
+- Uniquement pour les tâches d'implémentation nécessitant l'écriture de code
+
+**Non adapté pour :**
+- Tâches purement de recherche/exploration — pas besoin de quitter le mode planification
+- Vouloir demander à l'utilisateur « le plan est-il correct ? » — c'est exactement la fonction de cet outil, ne pas utiliser AskUserQuestion pour cela
+
+## Notes
+
+- Cet outil n'accepte pas le contenu du plan comme paramètre — il le lit à partir du fichier de plan écrit précédemment
+- L'utilisateur verra le contenu du fichier de plan pour l'approuver
+- Ne pas utiliser AskUserQuestion pour demander « le plan est-il correct ? » avant d'appeler cet outil, c'est redondant
+- Ne pas mentionner « plan » dans les questions, car l'utilisateur ne peut pas voir le contenu du plan avant ExitPlanMode
+
+## Signification dans cc-viewer
+
+L'appel à ExitPlanMode marque la fin de la phase de planification. Dans le journal des requêtes, les requêtes après cet appel se transforment généralement en opérations d'implémentation (Edit, Write, Bash, etc.).

package/concepts/fr/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Définition
+
+Outil rapide de correspondance de motifs de noms de fichiers, compatible avec des bases de code de toute taille. Renvoie les chemins de fichiers correspondants triés par date de modification.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `pattern` | string | Oui | Motif glob (comme `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Non | Répertoire de recherche, par défaut le répertoire de travail actuel. Ne pas passer « undefined » ou « null » |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Rechercher des fichiers par motif de nom
+- Trouver tous les fichiers d'un type spécifique (comme tous les fichiers `.tsx`)
+- Localiser des fichiers d'abord lors de la recherche de définitions de classes spécifiques (comme `class Foo`)
+- Plusieurs appels Glob peuvent être lancés en parallèle dans un seul message
+
+**Non adapté pour :**
+- Rechercher du contenu de fichiers — utiliser Grep
+- Exploration ouverte nécessitant plusieurs tours de recherche — utiliser Task (type Explore)
+
+## Notes
+
+- Supporte la syntaxe glob standard : `*` correspond à un niveau, `**` correspond à plusieurs niveaux, `{}` correspond à plusieurs choix
+- Les résultats sont triés par date de modification
+- Plus recommandé que la commande `find` de Bash
+
+## Signification dans cc-viewer
+
+Les appels Glob apparaissent dans le journal des requêtes comme des paires de content blocks `tool_use` / `tool_result`. Le `tool_result` contient la liste des chemins de fichiers correspondants.

package/concepts/fr/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Définition
+
+Puissant outil de recherche de contenu basé sur ripgrep. Supporte les expressions régulières, le filtrage par type de fichier et plusieurs modes de sortie.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `pattern` | string | Oui | Motif de recherche en expression régulière |
+| `path` | string | Non | Chemin de recherche (fichier ou répertoire), par défaut le répertoire de travail actuel |
+| `glob` | string | Non | Filtre de nom de fichier (comme `*.js`, `*.{ts,tsx}`) |
+| `type` | string | Non | Filtre de type de fichier (comme `js`, `py`, `rust`), plus efficace que glob |
+| `output_mode` | enum | Non | Mode de sortie : `files_with_matches` (par défaut), `content`, `count` |
+| `-i` | boolean | Non | Recherche insensible à la casse |
+| `-n` | boolean | Non | Afficher les numéros de ligne (mode content uniquement), par défaut true |
+| `-A` | number | Non | Nombre de lignes à afficher après la correspondance |
+| `-B` | number | Non | Nombre de lignes à afficher avant la correspondance |
+| `-C` / `context` | number | Non | Nombre de lignes à afficher avant et après la correspondance |
+| `head_limit` | number | Non | Limiter le nombre d'entrées en sortie, par défaut 0 (illimité) |
+| `offset` | number | Non | Ignorer les N premiers résultats |
+| `multiline` | boolean | Non | Activer le mode de correspondance multiligne, par défaut false |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Rechercher des chaînes ou motifs spécifiques dans la base de code
+- Trouver les emplacements d'utilisation de fonctions/variables
+- Filtrer les résultats de recherche par type de fichier
+- Compter le nombre de correspondances
+
+**Non adapté pour :**
+- Rechercher des fichiers par nom — utiliser Glob
+- Exploration ouverte nécessitant plusieurs tours de recherche — utiliser Task (type Explore)
+
+## Notes
+
+- Utilise la syntaxe ripgrep (pas grep), les caractères spéciaux comme les accolades doivent être échappés
+- Le mode `files_with_matches` ne renvoie que les chemins de fichiers, c'est le plus efficace
+- Le mode `content` renvoie le contenu des lignes correspondantes, supporte les lignes de contexte
+- La correspondance multiligne nécessite de définir `multiline: true`
+- Toujours préférer l'outil Grep aux commandes `grep` ou `rg` dans Bash
+
+## Signification dans cc-viewer
+
+Les appels Grep apparaissent dans le journal des requêtes comme des paires de content blocks `tool_use` / `tool_result`. Le `tool_result` contient les résultats de recherche.

package/concepts/fr/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Définition
+
+Remplace, insère ou supprime des cellules spécifiques dans un Jupyter notebook (fichier .ipynb).
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `notebook_path` | string | Oui | Chemin absolu du fichier notebook |
+| `new_source` | string | Oui | Nouveau contenu de la cellule |
+| `cell_id` | string | Non | ID de la cellule à éditer. En mode insertion, la nouvelle cellule est insérée après cet ID |
+| `cell_type` | enum | Non | Type de cellule : `code` ou `markdown`. Requis en mode insertion |
+| `edit_mode` | enum | Non | Mode d'édition : `replace` (par défaut), `insert`, `delete` |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Modifier des cellules de code ou markdown dans des Jupyter notebooks
+- Ajouter de nouvelles cellules à un notebook
+- Supprimer des cellules d'un notebook
+
+## Notes
+
+- `cell_number` est indexé à partir de 0
+- Le mode `insert` insère une nouvelle cellule à la position spécifiée
+- Le mode `delete` supprime la cellule à la position spécifiée
+- Le chemin doit être absolu
+
+## Signification dans cc-viewer
+
+Les appels NotebookEdit apparaissent dans le journal des requêtes comme des content blocks `tool_use`, enregistrant les opérations spécifiques de modification du notebook.

package/concepts/fr/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Définition
+
+Lit le contenu de fichiers depuis le système de fichiers local. Supporte les fichiers texte, images, PDF et Jupyter notebook.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `file_path` | string | Oui | Chemin absolu du fichier |
+| `offset` | number | Non | Numéro de ligne de départ (pour la lecture segmentée de gros fichiers) |
+| `limit` | number | Non | Nombre de lignes à lire (pour la lecture segmentée de gros fichiers) |
+| `pages` | string | Non | Plage de pages PDF (comme « 1-5 », « 3 », « 10-20 »), applicable uniquement aux PDF |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Lire des fichiers de code, fichiers de configuration et autres fichiers texte
+- Visualiser des fichiers image (Claude est un modèle multimodal)
+- Lire des documents PDF
+- Lire des Jupyter notebooks (renvoie toutes les cellules et sorties)
+- Lire plusieurs fichiers en parallèle pour obtenir du contexte
+
+**Non adapté pour :**
+- Lire des répertoires — utiliser la commande `ls` de Bash
+- Exploration ouverte de la base de code — utiliser Task (type Explore)
+
+## Notes
+
+- Le chemin doit être absolu, pas relatif
+- Par défaut, lit les 2000 premières lignes du fichier
+- Les lignes dépassant 2000 caractères seront tronquées
+- La sortie utilise le format `cat -n`, les numéros de ligne commencent à 1
+- Les gros PDF (plus de 10 pages) doivent spécifier le paramètre `pages`, maximum 20 pages par requête
+- Lire un fichier inexistant renvoie une erreur (pas de plantage)
+- Plusieurs appels Read peuvent être effectués en parallèle dans un seul message
+
+## Signification dans cc-viewer
+
+Les appels Read apparaissent dans le journal des requêtes comme des paires de content blocks `tool_use` (appel) et `tool_result` (contenu renvoyé). Le `tool_result` contient le contenu réel du fichier, permettant d'analyser quels fichiers le modèle a lus.

package/concepts/fr/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Définition
+
+Exécute une compétence (skill) dans la conversation principale. Les compétences sont des capacités spécialisées que l'utilisateur peut invoquer via des slash commands (comme `/commit`, `/review-pr`).
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `skill` | string | Oui | Nom de la compétence (comme « commit », « review-pr », « pdf ») |
+| `args` | string | Non | Arguments de la compétence |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- L'utilisateur a saisi un slash command au format `/<skill-name>`
+- La demande de l'utilisateur correspond à la fonctionnalité d'une compétence enregistrée
+
+**Non adapté pour :**
+- Commandes CLI intégrées (comme `/help`, `/clear`)
+- Une compétence déjà en cours d'exécution
+- Noms de compétences absents de la liste des compétences disponibles
+
+## Notes
+
+- Après invocation, la compétence se déploie en un prompt complet
+- Supporte les noms pleinement qualifiés (comme `ms-office-suite:pdf`)
+- La liste des compétences disponibles est fournie dans les messages system-reminder
+- Quand on voit une balise `<command-name>`, cela signifie que la compétence est déjà chargée et doit être exécutée directement plutôt que de rappeler cet outil
+- Ne pas mentionner une compétence sans avoir réellement appelé l'outil
+
+## Signification dans cc-viewer
+
+Les appels Skill apparaissent dans le journal des requêtes comme des content blocks `tool_use`. Le prompt déployé de la compétence affecte le system prompt ou le contenu des messages des requêtes suivantes.

package/concepts/fr/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Définition
+
+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.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `prompt` | string | Oui | Description de la tâche à exécuter par le sous-agent |
+| `description` | string | Oui | Résumé bref de 3-5 mots |
+| `subagent_type` | string | Oui | Type de sous-agent, détermine l'ensemble d'outils disponibles |
+| `model` | enum | Non | Spécifier le modèle (sonnet / opus / haiku), par défaut hérité du parent |
+| `max_turns` | integer | Non | Nombre maximum de tours agentiques |
+| `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 |
+| `resume` | string | Non | ID de l'agent à reprendre, continue depuis la dernière exécution |
+| `isolation` | enum | Non | Mode d'isolation, `worktree` crée un git worktree temporaire |
+
+## Types de sous-agents
+
+| Type | Utilité | Outils disponibles |
+|------|---------|-------------------|
+| `Bash` | Exécution de commandes, opérations git | Bash |
+| `general-purpose` | Tâches générales multi-étapes | Tous les outils |
+| `Explore` | Exploration rapide de la base de code | Tous les outils sauf Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Concevoir des plans d'implémentation | Tous les outils sauf Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Questions-réponses sur le guide d'utilisation de Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Configurer la barre d'état | Read, Edit |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Tâches complexes nécessitant une réalisation autonome en plusieurs étapes
+- Exploration de la base de code et recherche approfondie (utiliser le type Explore)
+- Travail parallèle nécessitant des environnements isolés
+- Tâches de longue durée nécessitant une exécution en arrière-plan
+
+**Non adapté pour :**
+- Lire des chemins de fichiers spécifiques — utiliser directement Read ou Glob
+- Rechercher dans 2-3 fichiers connus — utiliser directement Read
+- Rechercher des définitions de classes spécifiques — utiliser directement Glob
+
+## Notes
+
+- 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
+- Plusieurs appels Task peuvent être lancés en parallèle dans un seul message pour améliorer l'efficacité
+- Les tâches en arrière-plan vérifient la progression via l'outil TaskOutput
+- Le type Explore est plus lent que l'appel direct à Glob/Grep, à utiliser uniquement quand la recherche simple ne suffit pas
+
+## Signification dans cc-viewer
+
+Les appels Task 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.

package/concepts/fr/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Définition
+
+Crée des entrées structurées dans la liste de tâches pour suivre la progression, organiser des tâches complexes et montrer l'avancement du travail à l'utilisateur.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `subject` | string | Oui | Titre bref de la tâche, utiliser la forme impérative (comme « Fix authentication bug ») |
+| `description` | string | Oui | Description détaillée, incluant le contexte et les critères d'acceptation |
+| `activeForm` | string | Non | Texte au participe présent affiché quand la tâche est en cours (comme « Fixing authentication bug ») |
+| `metadata` | object | Non | Métadonnées arbitraires attachées à la tâche |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Tâches complexes multi-étapes (plus de 3 étapes)
+- L'utilisateur a fourni plusieurs éléments à faire
+- Suivre le travail en mode planification
+- L'utilisateur demande explicitement d'utiliser une liste de tâches
+
+**Non adapté pour :**
+- Une seule tâche simple
+- Opérations simples de 3 étapes ou moins
+- Requêtes purement conversationnelles ou informatives
+
+## Notes
+
+- Toutes les nouvelles tâches ont le statut initial `pending`
+- `subject` utilise la forme impérative (« Run tests »), `activeForm` utilise le participe présent (« Running tests »)
+- Après la création de la tâche, les relations de dépendance (blocks/blockedBy) peuvent être établies via TaskUpdate
+- Avant de créer, appeler TaskList pour vérifier s'il y a des tâches en double
+
+## Signification dans cc-viewer
+
+TaskCreate est une opération interne de gestion de tâches de Claude Code, elle ne produit pas de requêtes API indépendantes. Cependant, dans le Chat Mode, on peut voir le bloc tool_use où le modèle appelle cet outil.

package/concepts/fr/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Définition
+
+Obtient les détails complets d'une tâche via son ID.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `taskId` | string | Oui | ID de la tâche à obtenir |
+
+## Contenu renvoyé
+
+- `subject` — Titre de la tâche
+- `description` — Exigences détaillées et contexte
+- `status` — Statut : `pending`, `in_progress` ou `completed`
+- `blocks` — Liste des tâches bloquées par cette tâche
+- `blockedBy` — Liste des tâches préalables qui bloquent cette tâche
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Obtenir la description complète et le contexte d'une tâche avant de commencer à travailler
+- Comprendre les relations de dépendance d'une tâche
+- Obtenir les exigences complètes après avoir été assigné à une tâche
+
+## Notes
+
+- Après avoir obtenu la tâche, vérifier si la liste `blockedBy` est vide avant de commencer à travailler
+- Utiliser TaskList pour voir les informations résumées de toutes les tâches
+
+## Signification dans cc-viewer
+
+TaskGet est une opération interne de gestion de tâches, elle ne produit pas de requêtes API indépendantes.

package/concepts/fr/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Définition
+
+Liste toutes les tâches dans la liste de tâches pour voir la progression globale et le travail disponible.
+
+## Paramètres
+
+Aucun paramètre.
+
+## Contenu renvoyé
+
+Informations résumées de chaque tâche :
+- `id` — Identifiant de la tâche
+- `subject` — Description brève
+- `status` — Statut : `pending`, `in_progress` ou `completed`
+- `owner` — Responsable (agent ID), vide signifie non assigné
+- `blockedBy` — Liste des IDs de tâches incomplètes qui bloquent cette tâche
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Voir quelles tâches sont disponibles (statut pending, sans owner, non bloquées)
+- Vérifier la progression globale du projet
+- Trouver les tâches bloquées
+- Chercher la prochaine tâche après en avoir terminé une
+
+## Notes
+
+- Préférer traiter les tâches dans l'ordre des ID (ID le plus bas en premier), car les tâches antérieures fournissent généralement du contexte pour les suivantes
+- Les tâches avec `blockedBy` ne peuvent pas être réclamées tant que les dépendances ne sont pas résolues
+- Utiliser TaskGet pour obtenir les détails complets d'une tâche spécifique
+
+## Signification dans cc-viewer
+
+TaskList est une opération interne de gestion de tâches, elle ne produit pas de requêtes API indépendantes.

package/concepts/fr/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Définition
+
+Obtient la sortie des tâches en arrière-plan en cours d'exécution ou terminées. Applicable aux shells en arrière-plan, agents asynchrones et sessions distantes.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `task_id` | string | Oui | ID de la tâche |
+| `block` | boolean | Oui | Si l'on bloque en attendant la fin de la tâche, par défaut `true` |
+| `timeout` | number | Oui | Temps d'attente maximum (millisecondes), par défaut 30000, maximum 600000 |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Vérifier la progression des agents en arrière-plan lancés via Task (`run_in_background: true`)
+- Obtenir les résultats d'exécution de commandes Bash en arrière-plan
+- Attendre qu'une tâche asynchrone se termine et obtenir sa sortie
+
+**Non adapté pour :**
+- Tâches au premier plan — les tâches au premier plan renvoient directement les résultats, cet outil n'est pas nécessaire
+
+## Notes
+
+- `block: true` bloque jusqu'à ce que la tâche se termine ou que le délai expire
+- `block: false` est utilisé pour une vérification non bloquante de l'état actuel
+- L'ID de la tâche peut être trouvé via la commande `/tasks`
+- Applicable à tous les types de tâches : shells en arrière-plan, agents asynchrones, sessions distantes
+
+## Signification dans cc-viewer
+
+Les appels TaskOutput ne produisent pas de requêtes API en eux-mêmes, c'est une opération interne de gestion de tâches de Claude Code et n'apparaît pas dans le journal des requêtes.

package/concepts/fr/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Définition
+
+Arrête une tâche en arrière-plan en cours d'exécution.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `task_id` | string | Non | ID de la tâche en arrière-plan à arrêter |
+| `shell_id` | string | Non | Obsolète, utiliser `task_id` à la place |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Terminer des tâches de longue durée qui ne sont plus nécessaires
+- Annuler des tâches en arrière-plan lancées par erreur
+
+## Notes
+
+- Renvoie un statut de succès ou d'échec
+- Le paramètre `shell_id` est obsolète, utiliser `task_id`
+
+## Signification dans cc-viewer
+
+Les appels TaskStop ne produisent pas de requêtes API en eux-mêmes, ils font partie des opérations internes de gestion de tâches de Claude Code.

package/concepts/fr/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Définition
+
+Met à jour le statut, le contenu ou les relations de dépendance d'une tâche dans la liste de tâches.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `taskId` | string | Oui | ID de la tâche à mettre à jour |
+| `status` | enum | Non | Nouveau statut : `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Non | Nouveau titre |
+| `description` | string | Non | Nouvelle description |
+| `activeForm` | string | Non | Texte au participe présent affiché quand la tâche est en cours |
+| `owner` | string | Non | Nouveau responsable de la tâche (nom de l'agent) |
+| `metadata` | object | Non | Métadonnées à fusionner (définir à null pour supprimer une clé) |
+| `addBlocks` | string[] | Non | Liste des IDs de tâches bloquées par cette tâche |
+| `addBlockedBy` | string[] | Non | Liste des IDs de tâches préalables qui bloquent cette tâche |
+
+## Flux de statuts
+
+```
+pending → in_progress → completed
+```
+
+`deleted` peut être atteint depuis n'importe quel statut, supprime définitivement la tâche.
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Marquer une tâche comme `in_progress` au début du travail
+- Marquer une tâche comme `completed` à la fin du travail
+- Établir des relations de dépendance entre les tâches
+- Mettre à jour le contenu de la tâche quand les exigences changent
+
+**Règles importantes :**
+- Ne marquer comme `completed` que lorsque la tâche est entièrement terminée
+- Garder comme `in_progress` en cas d'erreurs ou de blocages
+- Ne pas marquer comme `completed` quand les tests échouent, l'implémentation est partielle ou des erreurs non résolues existent
+
+## Notes
+
+- Avant de mettre à jour, obtenir le statut le plus récent de la tâche via TaskGet pour éviter les données obsolètes
+- Après avoir terminé une tâche, appeler TaskList pour trouver la prochaine tâche disponible
+
+## Signification dans cc-viewer
+
+TaskUpdate est une opération interne de gestion de tâches, elle ne produit pas de requêtes API indépendantes.

package/concepts/fr/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Définition
+
+Récupère le contenu d'une page web à partir d'une URL spécifiée, convertit le HTML en markdown et traite le contenu avec un modèle d'IA selon le prompt.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `url` | string (URI) | Oui | URL complète à récupérer |
+| `prompt` | string | Oui | Décrit quelles informations extraire de la page |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Récupérer le contenu de pages web publiques
+- Consulter la documentation en ligne
+- Extraire des informations spécifiques de pages web
+
+**Non adapté pour :**
+- URLs nécessitant une authentification (Google Docs, Confluence, Jira, GitHub, etc.) — chercher d'abord des outils MCP dédiés
+- URLs GitHub — préférer utiliser le CLI `gh`
+
+## Notes
+
+- L'URL doit être une URL valide complète
+- HTTP est automatiquement mis à niveau vers HTTPS
+- Les résultats peuvent être résumés si le contenu est trop volumineux
+- Inclut un cache auto-nettoyant de 15 minutes
+- Quand l'URL redirige vers un hôte différent, l'outil renvoie l'URL de redirection et il faut refaire la requête avec la nouvelle URL
+- Si un outil web fetch fourni par MCP est disponible, préférer l'utiliser
+
+## Signification dans cc-viewer
+
+Les appels WebFetch apparaissent dans le journal des requêtes comme des paires de content blocks `tool_use` / `tool_result`. Le `tool_result` contient le résumé du contenu web traité par l'IA.

package/concepts/fr/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Définition
+
+Exécute des requêtes sur les moteurs de recherche et renvoie des résultats de recherche pour obtenir des informations à jour.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `query` | string | Oui | Requête de recherche (minimum 2 caractères) |
+| `allowed_domains` | string[] | Non | N'inclure que les résultats de ces domaines |
+| `blocked_domains` | string[] | Non | Exclure les résultats de ces domaines |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Obtenir des informations à jour au-delà de la date de coupure des connaissances du modèle
+- Rechercher des événements actuels et des données récentes
+- Rechercher la documentation technique la plus récente
+
+## Notes
+
+- Les résultats de recherche sont renvoyés au format d'hyperliens markdown
+- Après utilisation, une section « Sources: » doit être incluse à la fin de la réponse, listant les URLs pertinentes
+- Supporte le filtrage de domaines (inclusion/exclusion)
+- L'année en cours doit être utilisée dans les requêtes de recherche
+- Disponible uniquement aux États-Unis
+
+## Signification dans cc-viewer
+
+Les appels WebSearch apparaissent dans le journal des requêtes comme des paires de content blocks `tool_use` / `tool_result`. Le `tool_result` contient la liste des résultats de recherche.

package/concepts/fr/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Définition
+
+Écrit du contenu dans le système de fichiers local. Si le fichier existe déjà, il est écrasé.
+
+## Paramètres
+
+| Paramètre | Type | Requis | Description |
+|-----------|------|--------|-------------|
+| `file_path` | string | Oui | Chemin absolu du fichier (doit être un chemin absolu) |
+| `content` | string | Oui | Contenu à écrire |
+
+## Cas d'utilisation
+
+**Adapté pour :**
+- Créer de nouveaux fichiers
+- Quand il faut réécrire complètement le contenu d'un fichier
+
+**Non adapté pour :**
+- Modifier du contenu partiel d'un fichier — utiliser Edit
+- Ne pas créer proactivement des fichiers de documentation (*.md) ou README, sauf si l'utilisateur le demande explicitement
+
+## Notes
+
+- Si le fichier cible existe déjà, il doit d'abord être lu avec Read, sinon l'opération échouera
+- Écrase tout le contenu du fichier existant
+- Préférer Edit pour éditer des fichiers existants, Write uniquement pour créer de nouveaux fichiers ou des réécritures complètes
+
+## Signification dans cc-viewer
+
+Les appels Write apparaissent dans le journal des requêtes comme des content blocks `tool_use`, dont `input.content` contient le contenu complet écrit.