Tuto & FAQ

Tout ce qu'il faut savoir pour utiliser Cowork History.

🎛 Installer le plugin Cowork

1 Telecharger le plugin

Recuperez le fichier cowork-history.plugin. Il vous sera fourni directement ou disponible en telechargement.

2 Installer dans Cowork

Ouvrez l'application Cowork sur votre Mac. Allez dans Personnaliser (en bas a gauche) puis Plugins.

Glissez le fichier .plugin dans la fenetre, ou cliquez dessus directement — Cowork vous proposera de l'installer.

3 Demarrer une nouvelle session

Le plugin s'active au demarrage de chaque nouvelle session. Ouvrez une nouvelle conversation Cowork et vous verrez automatiquement la liste de vos conversations recentes.

💡 Le plugin a besoin d'acceder a votre dossier ~/.claude/ ou votre dossier Cowork pour fonctionner. Si vous montez votre dossier personnel, tout marchera automatiquement.

💻 Les commandes du plugin

🔍 /recall — Chercher dans l'historique

Tapez /recall suivi d'un mot-cle pour chercher dans toutes vos conversations passees.

/recall nintendo
# Trouve toutes les mentions de "nintendo" dans toutes vos conversations

/recall bug serveur
# Retrouve les discussions sur les bugs serveur

/recall cle API
# Retrouve ou vous avez mentionne une cle API

Claude vous montrera les messages correspondants avec leur date, le role (User/Assistant/Tool), et un extrait du texte autour du mot-cle.

📄 /context — Charger une conversation

Tapez /context suivi du sujet pour charger le resume d'une conversation passee.

/context LBC Scripts
# Charge le resume de la conversation "LBC Scripts"
# → Timeline, decisions prises, taches en cours

/context site web
# Retrouve la conversation ou vous avez travaille sur un site web

Ideal quand vous reprenez un projet apres une pause et que vous ne vous souvenez plus de l'etat d'avancement.

💡 Apres un /recall, Claude vous proposera d'utiliser /context pour charger la conversation complete. Les deux commandes se completent.

🖥 Utiliser le viewer web

1 Ouvrir un dossier

Cliquez sur Choisir un dossier et selectionnez le dossier qui contient vos fichiers JSONL de conversations Cowork.

Le viewer scanne le dossier et affiche toutes les conversations trouvees dans le panneau de gauche.

2 Naviguer dans les conversations

Cliquez sur une conversation dans la liste. Les messages s'affichent a droite avec un code couleur par role :

🔵 Bleu = User    🟢 Vert = Assistant    🟠 Orange = Tool

3 Rechercher

La barre de recherche en haut a gauche permet de chercher dans toutes les conversations simultanement.

Cliquez sur l'icone entonnoir pour ouvrir les filtres avances : role, type de contenu, dates, regex, etc.

4 Previsualiser et ouvrir

En cliquant sur un resultat de recherche, le message apparait dans un apercu en bas. Cliquez sur Ouvrir en plein pour sauter directement au message dans la conversation complete.

⚠️ Le viewer web fonctionne entierement cote client — vos fichiers ne sont jamais envoyes sur un serveur. Tout reste sur votre machine.

❓ Questions frequentes

Ou sont stockees mes conversations Cowork ?

Cowork stocke vos conversations en fichiers JSONL dans le dossier ~/.claude/projects/ sur votre Mac. Chaque conversation est un fichier .jsonl nomme avec un identifiant unique (UUID).

Si vous utilisez Cowork avec un dossier de travail, les conversations liees a ce dossier sont dans un sous-dossier dont le nom encode le chemin du projet.

Mes donnees sont-elles envoyees quelque part ?

Non. Le viewer web fonctionne entierement dans votre navigateur — les fichiers JSONL sont lus localement via l'API File System du navigateur. Rien n'est envoye sur internet.

Le plugin Cowork fonctionne aussi localement — il lit les fichiers directement sur votre machine via les outils Bash/Read/Grep.

Quelle difference entre le plugin et le viewer web ?

Le plugin s'utilise directement dans Cowork pendant que vous travaillez. Vous tapez /recall ou /context et Claude cherche pour vous sans quitter votre session.

Le viewer web est une interface visuelle pour naviguer dans vos conversations de maniere plus graphique — avec filtres, preview, scroll, etc. C'est complementaire.

Qu'est-ce que le mode Regex dans la recherche ?

Les expressions regulieres (regex) permettent des recherches avancees. Quelques exemples :

mot1|mot2 — cherche l'un OU l'autre

^bonjour — lignes qui commencent par "bonjour"

prix:\d+ — "prix:" suivi de chiffres

\btest\b — le mot "test" exact (pas "testing" ou "contest")

Activez le mode Regex en cochant la case dans les filtres avances du viewer.

Le plugin ne trouve pas mes conversations, que faire ?

Le plugin cherche les fichiers JSONL dans ~/.claude/ et dans le dossier monte par Cowork. Si rien n'est trouve :

1. Verifiez que vous avez bien monte un dossier dans Cowork (en bas a gauche, "Selectionner un dossier")

2. Essayez de monter votre dossier personnel (~) ou directement ~/.claude/

3. Si vos conversations sont dans un dossier d'archives (ex: CoworkArchives), montez ce dossier

C'est quoi un fichier JSONL ?

JSONL = JSON Lines. C'est un format texte ou chaque ligne est un objet JSON independant. Cowork utilise ce format pour enregistrer chaque message (question, reponse, appel d'outil) de vos conversations.

Vous n'avez pas besoin de comprendre le format — les outils (plugin et viewer) le lisent automatiquement pour vous.

Puis-je supprimer des conversations ?

Oui, les fichiers JSONL sont de simples fichiers sur votre disque. Vous pouvez les supprimer comme n'importe quel fichier. Le viewer et le plugin ne modifient jamais vos fichiers — ils les lisent uniquement.

Le plugin fonctionne-t-il avec Claude Code ?

Le plugin est concu pour Cowork (l'application desktop). Claude Code utilise le meme format de stockage (~/.claude/), donc les conversations Claude Code sont egalement trouvables avec /recall et le viewer web.

Mes conversations contiennent-elles des donnees sensibles ?

Oui, potentiellement. Vos conversations Cowork peuvent contenir des cles API, tokens, mots de passe, identifiants, ou d'autres informations sensibles que vous avez partages avec Claude pendant vos sessions.

Le plugin /recall inclut une detection automatique des patterns sensibles (cles commencant par sk-, ghp_, etc.) et les remplace par [REDACTED] dans les resultats affiches.

Recommandations :

— Ne partagez jamais les resultats bruts de /recall publiquement sans les verifier

— Si vous utilisez le viewer web, rappelez-vous que tout reste local dans votre navigateur

— Supprimez les fichiers JSONL contenant des secrets si vous n'en avez plus besoin