cc-viewer 1.7.21 → 1.7.23

package/concepts/es/Tool-TodoWrite.md

@@ -0,0 +1,43 @@
+# TodoWrite
+
+Escribe una lista de tareas estructurada para la sesión actual, reemplazando la lista anterior. Cada elemento lleva su texto, un estado y una forma en presente continuo que se muestra en los indicadores de progreso.
+
+## Cuándo usar
+
+- Una tarea tiene varios pasos distintos y rastrearlos te ayuda a ti (y al usuario) a ver el progreso.
+- El usuario pide explícitamente una lista de tareas.
+- Quieres marcar exactamente un elemento como en progreso mientras el resto permanecen pendientes o completados.
+
+## Activación
+
+- Herramienta heredada: desactivada por defecto en sesiones que ofrecen las herramientas de tareas (`TaskCreate`, `TaskUpdate`, `TaskList`).
+- Reactívala con `CLAUDE_CODE_ENABLE_TASKS=0`.
+
+## Parámetros
+
+- `todos` (array, obligatorio): La lista de tareas completa y actualizada. Cada entrada tiene:
+  - `content` (string): La descripción de la tarea.
+  - `status` (string): Uno de `pending`, `in_progress`, `completed`.
+  - `activeForm` (string): Texto en presente continuo mostrado mientras el elemento está en progreso (p. ej. "Running tests").
+
+## Ejemplos
+
+### Ejemplo 1: Rastrear un cambio de tres pasos
+
+```
+TodoWrite(
+  todos=[
+    {content="Update the parser", status="in_progress", activeForm="Updating the parser"},
+    {content="Add unit tests", status="pending", activeForm="Adding unit tests"},
+    {content="Run the full test suite", status="pending", activeForm="Running the full test suite"}
+  ]
+)
+```
+
+La lista completa se reescribe en cada llamada — incluye siempre todos los elementos, no solo los que cambiaron.
+
+## Notas
+
+- La lista se reemplaza por completo en cada llamada; para actualizar un elemento, vuelve a enviar todos los elementos con el nuevo estado.
+- Mantén exactamente un elemento `in_progress` a la vez.
+- En sesiones donde las herramientas de tareas estructuradas (`TaskCreate`/`TaskUpdate`/`TaskList`) están habilitadas, el harness puede ofrecer esas en lugar de `TodoWrite` — prefiere el conjunto de herramientas que esté anunciado.

package/concepts/es/Tool-ToolSearch.md

@@ -10,6 +10,11 @@ Recupera bajo demanda las definiciones de esquema completas de las «herramienta
 
 Si el esquema de una herramienta ya está en el contexto, no vuelvas a buscar — simplemente invócala.
 
+## Activación
+
+- Activado por defecto.
+- Se desactiva cuando `ANTHROPIC_BASE_URL` apunta a un endpoint que no es de Anthropic (salvo que `ENABLE_TOOL_SEARCH` esté establecido), cuando `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` está establecido, cuando el modelo carece de soporte de referencia de herramientas (modelos Vertex AI anteriores a Claude 4.5), o cuando se deniega mediante `"deny": ["ToolSearch"]`.
+
 ## Parámetros
 
 - `query` (string, obligatorio): La consulta usada para localizar herramientas diferidas. Se admiten tres formas:

package/concepts/es/Tool-WebSearch.md

@@ -10,6 +10,12 @@ Realiza una búsqueda web en vivo y devuelve resultados clasificados que el asis
 - Verificar un hecho que puede haber cambiado desde que el modelo fue entrenado.
 - Descubrir múltiples perspectivas sobre un tema antes de obtener cualquier página individual con `WebFetch`.
 
+## Activación
+
+- La disponibilidad depende del proveedor y del modelo: disponible en la API de Anthropic y en Claude Platform on AWS; en Microsoft Foundry requiere un despliegue alojado por Anthropic; en Google Cloud funciona con modelos Claude 4+.
+- No disponible en Amazon Bedrock.
+- Limita a 200 llamadas por sesión con `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`.
+
 ## Parámetros
 
 - `query` (string, obligatorio): La consulta de búsqueda. Longitud mínima 2 caracteres. Incluye el año actual cuando preguntes por información "última" o "reciente" para que los resultados estén frescos.

package/concepts/es/Tools.md

@@ -15,16 +15,19 @@ A continuación se presenta el índice clasificado de todas las herramientas.
 | [TaskGet](Tool-TaskGet.md) | Obtener detalles de una tarea |
 | [TaskUpdate](Tool-TaskUpdate.md) | Actualizar el estado, dependencias, etc. de una tarea |
 | [TaskList](Tool-TaskList.md) | Listar todas las tareas |
+| [ListAgents](Tool-ListAgents.md) | Listar los agents disponibles en la sesión |
 
 ## Team & Orquestación
 
 | Herramienta | Propósito |
 |-------------|-----------|
-| [TeamCreate](Tool-TeamCreate.md) | Crear un equipo de agents para trabajo colaborativo |
-| [TeamDelete](Tool-TeamDelete.md) | Disolver un equipo de agents |
 | [SendMessage](Tool-SendMessage.md) | Enviar un mensaje a otro agent |
 | [Workflow](Tool-Workflow.md) | Ejecutar un script de orquestación multi-agent determinista |
 | [Monitor](Tool-Monitor.md) | Transmitir eventos de un script de larga ejecución como notificaciones |
+| [SendFile](Tool-SendFile.md) | Enviar archivos a otra sesión de Claude Code |
+| [SendUserFile](Tool-SendUserFile.md) | Enviar archivos al usuario |
+| [SendUserMessage](Tool-SendUserMessage.md) | Enviar un mensaje al usuario (herramienta Brief heredada) |
+| [EndConversation](Tool-EndConversation.md) | Terminar la conversación actual |
 
 ## Operaciones de archivos
 
@@ -48,6 +51,7 @@ A continuación se presenta el índice clasificado de todas las herramientas.
 | Herramienta | Propósito |
 |-------------|-----------|
 | [Bash](Tool-Bash.md) | Ejecutar comandos shell |
+| [REPL](Tool-REPL.md) | Ejecutar JavaScript en un REPL de Node.js persistente |
 
 ## Web
 
@@ -66,6 +70,10 @@ A continuación se presenta el índice clasificado de todas las herramientas.
 | [ExitPlanMode](Tool-ExitPlanMode.md) | Salir del modo de planificación y enviar el plan para aprobación del usuario |
 | [AskUserQuestion](Tool-AskUserQuestion.md) | Hacer preguntas al usuario para obtener aclaraciones o decisiones |
 | [ReportFindings](Tool-ReportFindings.md) | Reportar hallazgos de revisión de código como lista tipada para la UI anfitriona |
+| [TodoWrite](Tool-TodoWrite.md) | Escribir una lista de tareas estructurada para la sesión |
+| [SendFeedback](Tool-SendFeedback.md) | Enviar feedback estructurado sobre Claude Code a Anthropic |
+| [Projects](Tool-Projects.md) | Gestionar documentos de la base de conocimiento del proyecto |
+| [ProposeGoal](Tool-ProposeGoal.md) | Proponer una meta de finalización verificable para la sesión |
 
 ## Worktrees
 
@@ -84,6 +92,7 @@ A continuación se presenta el índice clasificado de todas las herramientas.
 | [ScheduleWakeup](Tool-ScheduleWakeup.md) | Auto-marcador de iteraciones /loop programando el siguiente despertar |
 | [PushNotification](Tool-PushNotification.md) | Enviar notificación de escritorio/móvil al usuario |
 | [RemoteTrigger](Tool-RemoteTrigger.md) | Gestionar rutinas de remote-trigger de claude.ai |
+| [ReadNotifications](Tool-ReadNotifications.md) | Leer notificaciones pendientes de la sesión |
 
 ## Extensiones
 
@@ -91,10 +100,23 @@ A continuación se presenta el índice clasificado de todas las herramientas.
 |-------------|-----------|
 | [Skill](Tool-Skill.md) | Ejecutar una habilidad (slash command) |
 
+## MCP y extensiones
+
+| Herramienta | Propósito |
+|-------------|-----------|
+| [ListMcpResources](Tool-ListMcpResources.md) | Listar recursos expuestos por servidores MCP conectados |
+| [ReadMcpResource](Tool-ReadMcpResource.md) | Leer un único recurso de un servidor MCP por URI |
+| [ReadMcpResourceDir](Tool-ReadMcpResourceDir.md) | Listar un recurso MCP estilo directorio por URI |
+| [SearchMcpRegistry](Tool-SearchMcpRegistry.md) | Buscar en el registro de conectores MCP por palabra clave |
+| [SuggestConnectors](Tool-SuggestConnectors.md) | Resolver detalles de conectores a partir de resultados de búsqueda del registro |
+| [ListConnectors](Tool-ListConnectors.md) | Listar conectores MCP instalados |
+| [SuggestPluginInstall](Tool-SuggestPluginInstall.md) | Mostrar una tarjeta de instalación de plugin en línea |
+| [SuggestSkills](Tool-SuggestSkills.md) | Mostrar una tarjeta de skills añadibles |
+| [ListPlugins](Tool-ListPlugins.md) | Listar plugins de claude.ai habilitados |
+| [ListSkills](Tool-ListSkills.md) | Listar skills de claude.ai habilitadas |
+
 ## Integración con IDE
 
 | Herramienta | Propósito |
 |-------------|-----------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Obtener información de diagnóstico del lenguaje de VS Code |
-| [executeCode](Tool-executeCode.md) | Ejecutar código en el kernel de Jupyter |
 | [LSP](Tool-LSP.md) | Consultas de servidor de lenguaje (definiciones, referencias, símbolos) |

package/concepts/fr/Tool-Artifact.md

@@ -9,6 +9,13 @@ Rendre un fichier HTML ou Markdown dans un Artifact — une page web hébergée
 - Lister les artifacts existants de l'utilisateur pour en trouver un d'une session antérieure (`action: "list"`)
 - **Pas** pour du contenu qui doit rester local, des réponses en texte brut ou quoi que ce soit nécessitant des ressources réseau externes au moment de la visualisation — une CSP stricte bloque chaque hôte externe
 
+## Activation
+
+- Nécessite un forfait Pro, Max, Team ou Enterprise avec connexion claude.ai (`/login`).
+- API Anthropic uniquement — non disponible sur Amazon Bedrock, Google Cloud ou Microsoft Foundry.
+- Nécessite Claude Code ≥ 2.1.183 ou l'application Desktop ≥ 1.13576.0.
+- Désactiver avec le paramètre `disableArtifact` ou `CLAUDE_CODE_DISABLE_ARTIFACT=1`.
+
 ## Paramètres
 
 - `file_path` (chaîne) : Chemin vers le fichier `.html` ou `.md` à rendre. Le fichier est enrobé dans un squelette de document au moment de la publication, donc écrivez le contenu de la page directement — pas de balises `<!DOCTYPE>`, `<html>`, `<head>` ou `<body>`. Même chemin → même URL au redéploiement ; un chemin différent réclame une nouvelle URL.

package/concepts/fr/Tool-EndConversation.md

@@ -0,0 +1,35 @@
+# EndConversation
+
+Met fin à la conversation courante et empêche l'envoi de tout message supplémentaire.
+
+## Quand l'utiliser
+
+- Uniquement en cas d'abus soutenu de la part de l'utilisateur, ou lorsque l'utilisateur demande explicitement une démonstration de cet outil.
+
+C'est une action de dernier recours : les propres règles de l'outil exigent d'avertir d'abord l'utilisateur et de confirmer avant l'utilisation, et il ne doit jamais être utilisé dans des situations d'automutilation ou liées à un préjudice.
+
+## Activation
+
+- Nécessite Claude Code 2.1.213+ et un modèle de la famille Opus 4.8 / Sonnet 5 / Fable 5 ou ultérieure.
+- Sessions terminal interactives uniquement — jamais en mode `--bare`, et jamais disponible pour les sous-agents.
+- Non disponible sur Amazon Bedrock, Claude Platform on AWS, Vertex AI, Microsoft Foundry ou les passerelles cloud.
+- Nécessite un drapeau de fonctionnalité côté serveur — la plupart des sessions ne proposent pas cet outil.
+
+## Paramètres
+
+Cet outil ne prend aucun paramètre.
+
+## Exemples
+
+### Exemple 1 : mettre fin à la conversation
+
+```
+EndConversation()
+```
+
+Le flux se fait en deux étapes : le premier appel renvoie un message de réflexion ; un second appel immédiatement après met réellement fin à la conversation (`ended: true`).
+
+## Notes
+
+- Fortement contrôlé : nécessite un modèle pris en charge, le point d'entrée CLI et un drapeau de fonctionnalité côté serveur — la plupart des sessions ne proposent pas cet outil.
+- Une fois terminée, aucun autre message ne peut être envoyé dans la conversation.

package/concepts/fr/Tool-LSP.md

@@ -10,6 +10,11 @@ Interroge les serveurs Language Server Protocol (LSP) pour obtenir de l'intellig
 - Trouver les implémentations d'une interface ou d'une méthode abstraite (`goToImplementation`)
 - Parcourir la hiérarchie d'appels d'une fonction (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
 
+## Activation
+
+- Inactif jusqu'à ce qu'un plugin d'intelligence de code pour le langage soit installé (le binaire du serveur est installé séparément).
+- L'outil n'apparaît que lorsqu'un client LSP est connecté.
+
 ## Paramètres
 
 - `operation` (string, requis) : l'une des opérations énumérées ci-dessus.

package/concepts/fr/Tool-ListAgents.md

@@ -0,0 +1,35 @@
+# ListAgents
+
+Liste les agents auxquels vous pouvez envoyer un `SendMessage` : les sous-agents in-process que vous avez lancés, les autres sessions Claude locales sur cette machine, vos sessions cloud (lorsque cette session a un accès cloud) et — lorsque Remote Control est connecté — les autres sessions de votre compte. Chaque ligne est étiquetée par type.
+
+## Quand l'utiliser
+
+- Vous avez besoin du nom exact d'une session pair ou d'un sous-agent avant de lui envoyer un message.
+- Vous voulez voir quelles sessions sont actuellement joignables depuis celle-ci.
+
+## Activation
+
+- Nécessite Claude Code 2.1.224+ et la messagerie inter-sessions (un drapeau de fonctionnalité côté serveur, désactivé par défaut).
+- La messagerie inter-sessions n'est pas disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform et Microsoft Foundry.
+- Désactivé lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `DISABLE_GROWTHBOOK` est défini.
+- Activer de force avec `CLAUDE_CODE_HARBOR_KITE=1`.
+
+## Paramètres
+
+- `channel` (string, optionnel) : non disponible dans cette version ; laissez non défini.
+- `q` (string, optionnel) : non disponible dans cette version ; laissez non défini.
+
+## Exemples
+
+### Exemple 1 : lister les agents joignables
+
+```
+ListAgents()
+```
+
+Chaque ligne affiche un nom — ce nom est l'adresse. Envoyez avec `SendMessage({to: "<name>", message: "..."})`, en copiant le nom exactement tel qu'affiché. Ajoutez le ` [ref]` d'une ligne uniquement lorsque le nom nu est ambigu (deux lignes le partagent, ou une erreur vous demande de désambiguïser).
+
+## Notes
+
+- Lecture seule et sûr en concurrence.
+- Une session cloud reçoit votre message mais ne peut pas encore répondre — lisez sa réponse dans sa propre transcription.

package/concepts/fr/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+Liste les connecteurs MCP installés pour l'organisation claude.ai de l'utilisateur, éventuellement filtrés par mot-clé.
+
+## Quand l'utiliser
+
+- Vous devez savoir quels connecteurs sont déjà installés avant d'en suggérer de nouveaux.
+- L'utilisateur demande quelles intégrations son organisation possède.
+
+## Activation
+
+- Disponible uniquement dans les sessions distantes (claude.ai) sur l'API first-party.
+
+## Paramètres
+
+- `keywords` (array de strings, optionnel) : filtre la liste — jusqu'à 8 éléments, 1 à 64 caractères chacun. Omettez pour tout lister.
+
+## Exemples
+
+### Exemple 1 : lister tous les connecteurs installés
+
+```
+ListConnectors()
+```
+
+### Exemple 2 : filtrer par mot-clé
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## Notes
+
+- Associez à `SearchMcpRegistry` (découverte) et `SuggestConnectors` (détails) pour le flux complet trouver-et-activer.

package/concepts/fr/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+Liste les ressources exposées par les serveurs MCP connectés, éventuellement filtrées sur un seul serveur.
+
+## Quand l'utiliser
+
+- Vous devez découvrir quelles ressources (fichiers, enregistrements, documents) un serveur MCP offre avant de les lire.
+- Vous voulez un aperçu de toutes les ressources de chaque serveur connecté.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, optionnel) : nom du serveur par lequel filtrer les ressources. Omettez pour lister les ressources de tous les serveurs connectés.
+
+## Exemples
+
+### Exemple 1 : tout lister
+
+```
+ListMcpResources()
+```
+
+### Exemple 2 : lister les ressources d'un seul serveur
+
+```
+ListMcpResources(server="github")
+```
+
+## Notes
+
+- C'est l'étape de découverte : injectez les URI intéressants dans `ReadMcpResource` (ressource unique) ou `ReadMcpResourceDir` (listages de répertoires).
+- Les serveurs se connectent et se déconnectent au cours de la vie de la session ; relistez si un serveur vient d'être ajouté.

package/concepts/fr/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Liste les plugins claude.ai activés de l'utilisateur, éventuellement filtrés par mot-clé.
+
+## Quand l'utiliser
+
+- Vous devez savoir quels plugins sont déjà activés — par exemple, pour confirmer ce qui a été installé après une carte `SuggestPluginInstall`.
+- L'utilisateur demande quels plugins il possède.
+
+## Activation
+
+- Nécessite la permission d'accès au registre de plugins.
+- La disponibilité dépend du type de session et du déploiement de fonctionnalité — désactivé dans les environnements HIPAA, toujours disponible dans les sessions distantes.
+
+## Paramètres
+
+- `keywords` (array de strings, optionnel) : filtre la liste — jusqu'à 8 éléments, 1 à 64 caractères chacun. Omettez pour tout lister.
+
+## Exemples
+
+### Exemple 1 : lister les plugins activés
+
+```
+ListPlugins()
+```
+
+### Exemple 2 : filtrer par mot-clé
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Notes
+
+- Si le catalogue de plugins est inaccessible (interdit), l'outil se replie sur une liste vide avec un avertissement plutôt que d'échouer.

package/concepts/fr/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Liste les skills claude.ai activées de l'utilisateur, éventuellement filtrées par mot-clé.
+
+## Quand l'utiliser
+
+- Vous avez besoin de la liste faisant autorité des skills actuellement activées — avant d'en invoquer une, ou pour confirmer ce qu'une carte `SuggestSkills` a ajouté.
+- L'utilisateur demande quelles skills il possède.
+
+## Activation
+
+- Nécessite la permission d'accès au registre de plugins.
+- Désactivé dans les environnements HIPAA.
+- Toujours disponible dans les sessions distantes.
+
+## Paramètres
+
+- `keywords` (array de strings, optionnel) : filtre la liste — jusqu'à 8 éléments, 1 à 64 caractères chacun. Omettez pour tout lister.
+
+## Exemples
+
+### Exemple 1 : lister les skills activées
+
+```
+ListSkills()
+```
+
+### Exemple 2 : filtrer par mot-clé
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Notes
+
+- Si le catalogue est inaccessible (interdit), l'outil se replie sur une liste vide avec un avertissement plutôt que d'échouer.
+- Ceci liste les skills *activées* ; utilisez `SuggestSkills` pour faire apparaître les skills que l'utilisateur pourrait ajouter.

package/concepts/fr/Tool-Monitor.md

@@ -10,6 +10,13 @@ Lance un moniteur en arrière-plan qui diffuse des événements depuis un script
 - Attendre une condition spécifique sur de nombreuses itérations (par exemple un jalon d'étape d'entraînement ou le vidage d'une file d'attente)
 - **Pas** pour un simple "attendre jusqu'à la fin" — utiliser `Bash` avec `run_in_background` pour cela ; il émet une notification de fin lorsque le processus se termine
 
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- Indisponible sur Amazon Bedrock, Google Cloud et Microsoft Foundry.
+- Désactivé lorsque `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini.
+- La source WebSocket nécessite Claude Code 2.1.195+.
+
 ## Paramètres
 
 - `command` (chaîne, obligatoire) : La commande shell ou le script à exécuter. Chaque ligne écrite sur la sortie standard devient un événement de notification distinct. Le moniteur se termine quand le processus se termine.

package/concepts/fr/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Gère les documents de projet dans la base de connaissances du projet Claude de l'utilisateur : lire, rechercher, écrire et supprimer des documents, ou récupérer les informations du projet.
+
+## Quand l'utiliser
+
+- Persister un document (livrable, notes, matériel de référence) dans le projet de l'utilisateur afin qu'il survive à la session.
+- Lire ou rechercher des documents de projet existants pour ancrer la tâche courante dans un contexte antérieur.
+- Téléverser un fichier local dans le projet sans charger son contenu dans le contexte.
+- Supprimer un document de projet obsolète.
+
+## Paramètres
+
+- `method` (string, requis) : l'une des valeurs `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, optionnel) : pour `project_read`/`project_write`/`project_delete` : le chemin du document. Pour `project_write` : un chemin existant est remplacé sur place ; un nouveau nom de fichier nu (sans "/") est placé sous l'espace de noms `claude/<name>`.
+- `content` (string, optionnel) : pour `project_write` : texte du document en ligne. Mutuellement exclusif avec `local_path`.
+- `local_path` (string, optionnel) : pour `project_write` : un fichier situé dans le répertoire de travail à téléverser — son contenu n'entre jamais dans votre contexte. Mutuellement exclusif avec `content`.
+- `present_to_user` (boolean, optionnel) : pour `project_write` : marque ce document comme le livrable que l'utilisateur doit voir. Défaut false ; laissez non défini pour les sauvegardes de routine et les écritures en masse.
+- `query` (string, optionnel) : pour `project_search` : requête sur la base de connaissances.
+- `n` (number, optionnel) : pour `project_search` : nombre de résultats (défaut 5).
+
+## Exemples
+
+### Exemple 1 : écrire le livrable dans le projet
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Téléverse le fichier local sans faire entrer son contenu dans le contexte, et le signale comme le livrable de l'utilisateur.
+
+### Exemple 2 : rechercher dans la base de connaissances
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Notes
+
+- `content` est destiné au texte que vous composez en ligne ; `local_path` à tout ce qui est déjà sur le disque — ne mélangez jamais les deux.
+- Utilisez `present_to_user=true` avec parcimonie : uniquement pour le document que l'utilisateur a demandé ou sur lequel il doit agir.

package/concepts/fr/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Propose un objectif d'achèvement vérifiable pour la session. L'objectif est montré à l'utilisateur dans une boîte de dialogue d'approbation (par défaut) et, une fois défini, guide le reste de la conversation vers un résultat vérifiable.
+
+## Quand l'utiliser
+
+- La session a un état final concret qu'un évaluateur pourrait vérifier à partir de la conversation (p. ex. "all tests in test/auth pass").
+- Vous voulez l'accord explicite de l'utilisateur sur ce que « terminé » signifie avant d'entreprendre un travail substantiel.
+- Les propres mots de l'utilisateur ont déjà énoncé le résultat et vous voulez qu'il soit enregistré comme objectif de session.
+
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- Exclu des sessions interactives et en arrière-plan.
+- Désactivé par la clé de paramètres `modelProposedGoals: "disabled"`.
+
+## Paramètres
+
+- `condition` (string, requis) : la condition d'achèvement, écrite de sorte qu'un évaluateur distinct puisse la vérifier à partir de la conversation (p. ex. "all tests in test/auth pass (bun test exits 0)"). Au maximum 500 caractères — l'utilisateur doit pouvoir lire la condition entière dans la boîte de dialogue d'approbation.
+- `ask_user` (boolean, optionnel) : s'il faut demander l'approbation de l'utilisateur avant que l'objectif ne soit défini. Défaut true (une boîte de dialogue d'approbation est affichée). Mettez false UNIQUEMENT lorsque les propres mots de l'utilisateur dans cette conversation ont énoncé ce résultat comme ce qu'il veut ; l'objectif est alors défini directement avec un avis visible, et l'utilisateur peut l'effacer avec `/goal clear`.
+
+## Exemples
+
+### Exemple 1 : proposer un objectif adossé à des tests
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+L'utilisateur voit la condition dans une boîte de dialogue d'approbation et peut l'accepter, l'éditer ou la rejeter.
+
+### Exemple 2 : adopter directement le résultat énoncé par l'utilisateur
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Valable uniquement parce que l'utilisateur a explicitement énoncé ce résultat plus tôt dans la conversation.
+
+## Notes
+
+- Gardez `condition` courte et objectivement vérifiable — les objectifs vagues ("make it better") vont à l'encontre du but.
+- `ask_user=false` est strictement limité aux résultats que l'utilisateur a lui-même énoncés ; tout le reste doit passer par la boîte de dialogue d'approbation.

package/concepts/fr/Tool-PushNotification.md

@@ -14,6 +14,12 @@ Envoie une notification de bureau depuis la session Claude Code en cours. Si Rem
 
 N'envoyez pas de notification pour des mises à jour de progression routinières en cours de tâche, ni pour confirmer que vous avez répondu à quelque chose que l'utilisateur vient clairement de demander et attend. Ne notifiez pas lorsqu'une tâche courte se termine — si l'utilisateur vient de la soumettre et attend, la notification n'apporte aucune valeur et érode la confiance dans les notifications futures. Penchez fortement vers l'absence d'envoi.
 
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- La livraison passe par l'infrastructure hébergée par Anthropic — non disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud ou Microsoft Foundry.
+- Le push téléphone nécessite en plus un client Remote Control connecté.
+
 ## Paramètres
 
 - `message` (chaîne, obligatoire) : le corps de la notification. Gardez-le sous 200 caractères ; les systèmes d'exploitation mobiles tronquent les chaînes plus longues. Commencez par ce sur quoi l'utilisateur agirait : "build failed: 2 auth tests" est plus utile que "task complete".

package/concepts/fr/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Exécute du JavaScript dans un contexte vm Node.js persistant au sein de la session. Le `await` de premier niveau est pris en charge, et les variables/fonctions définies lors d'un appel restent disponibles lors des appels suivants.
+
+## Quand l'utiliser
+
+- Calcul rapide, transformation de données ou manipulation de JSON plus faciles en code qu'en lignes de commande shell.
+- Scripting multi-étapes où l'état intermédiaire doit persister entre les appels (compteurs, résultats accumulés).
+- Sonder le comportement d'une API ou d'une bibliothèque de façon interactive avant de l'écrire dans un fichier.
+
+## Activation
+
+- Désactivé par défaut — définissez `CLAUDE_CODE_REPL=true` pour l'activer.
+- Dans les sessions terminal (`cli`) et claude.ai (`remote`), un drapeau de fonctionnalité côté serveur peut également l'activer.
+- Lorsqu'il est désactivé, REPL est masqué de la liste d'outils du modèle. Lorsqu'il est activé, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` et `NotebookEdit` sont remplacés par les raccourcis REPL.
+
+## Paramètres
+
+- `code` (string, requis) : code JavaScript à exécuter. Prend en charge le await de premier niveau. L'état persiste d'un appel à l'autre.
+- `description` (string, optionnel) : description claire et concise de ce que fait ce script à la voix active (5 à 10 mots), p. ex. "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, optionnel) : délai d'expiration en millisecondes. Défaut 30000 ; maximum 600000.
+
+## Exemples
+
+### Exemple 1 : calculer et réutiliser un état
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Renvoie `2` ; `counts` reste défini pour les appels REPL suivants dans la même session.
+
+### Exemple 2 : await de premier niveau avec un délai plus long
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Notes
+
+- L'état est propre à la session : redémarrer la session efface toutes les définitions.
+- C'est un environnement JavaScript (Node) — utilisez Bash pour les commandes shell, les travaux lourds sur le système de fichiers ou les runtimes non JS.
+- Le code de longue durée doit définir un `timeout` explicite ; le défaut de 30 s tue tout ce qui est plus lent.

package/concepts/fr/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Lit une seule ressource exposée par un serveur MCP (Model Context Protocol) connecté, adressée par son URI.
+
+## Quand l'utiliser
+
+- Un serveur MCP annonce une ressource (fichier, enregistrement, document) dont vous avez besoin du contenu dans le contexte.
+- Vous disposez d'un URI de ressource concret — provenant de `ListMcpResources`, de la documentation du serveur ou d'un résultat d'outil précédent.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, requis) : le nom du serveur MCP.
+- `uri` (string, requis) : l'URI de la ressource à lire.
+
+## Exemples
+
+### Exemple 1 : lire une ressource de serveur par URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Renvoie le contenu de la ressource tel que fourni par le serveur MCP `github`.
+
+## Notes
+
+- Utilisez d'abord `ListMcpResources` si vous ne savez pas quelles ressources un serveur expose ; utilisez `ReadMcpResourceDir` pour les listages de type répertoire.
+- Le schéma d'URI est spécifique au serveur (`file://`, `https://`, schémas personnalisés) — vérifiez ce que le serveur cible annonce.

package/concepts/fr/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Liste les entrées d'une ressource de type répertoire exposée par un serveur MCP connecté, adressée par son URI.
+
+## Quand l'utiliser
+
+- Un serveur MCP organise ses ressources de façon hiérarchique et vous devez énumérer un niveau de cette hiérarchie.
+- Vous voulez parcourir avant de lire des ressources individuelles avec `ReadMcpResource`.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, requis) : le nom du serveur MCP.
+- `uri` (string, requis) : l'URI de la ressource répertoire à lister.
+
+## Exemples
+
+### Exemple 1 : lister un répertoire de ressources
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Renvoie les entrées enfants que le serveur expose sous cet URI de répertoire.
+
+## Notes
+
+- Seuls les serveurs qui modélisent leurs ressources comme des répertoires prennent cela en charge ; les serveurs plats renverront une erreur ou un listage vide — repliez-vous sur `ListMcpResources`.
+- Combinez avec `ReadMcpResource` pour descendre dans les entrées qui semblent pertinentes.

package/concepts/fr/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Lit les notifications en file d'attente pour l'assistant dans la session courante — activité GitHub sur les PR suivies (`github_webhook`), déclenchements planifiés (`trigger_fire`) et messages provenant d'autres sessions Claude (`mcp_send_message`).
+
+## Quand l'utiliser
+
+- Vous avez été notifié que quelque chose s'est produit — une PR suivie a été mise à jour, un déclencheur planifié s'est déclenché, une autre session vous a envoyé un message — et vous avez besoin de la charge utile réelle.
+- Vider un arriéré : les gros lots sont renvoyés en plusieurs parties, continuez donc à appeler jusqu'à ce que le résultat indique 0 `remaining`.
+
+## Paramètres
+
+Cet outil ne prend aucun paramètre.
+
+## Exemples
+
+### Exemple 1 : vider les notifications en attente
+
+```
+ReadNotifications()
+```
+
+Renvoie les notifications en file d'attente, les plus anciennes d'abord. Le résultat inclut un compte `remaining` des notifications encore en attente après cette lecture — appelez à nouveau l'outil pour les lire.
+
+## Notes
+
+- Les lectures sont limitées en taille : un appel suivant renvoie le reste de la MÊME file (plus tout ce qui est nouvellement arrivé), pas seulement les nouvelles arrivées. Bouclez jusqu'à ce que `remaining` soit 0.
+- Les notifications proviennent des webhooks GitHub sur les PR suivies, des déclencheurs planifiés et des messages d'autres sessions Claude ; il n'y a pas de paramètre de filtrage dans la version courante.