Qu’est-ce que Kensaku ?
Kensaku est une application de recherche de bureau open source pour Windows, macOS et Linux. Elle indexe les noms de fichiers, le texte des PDF, des fichiers Office, des EPUB, des e-mails et de plus de 50 formats de code et de données, le texte lu par OCR dans les captures d'écran, ainsi qu'un petit modèle d'embeddings pour la recherche par le sens. Son binaire kensaku-cli lance un serveur MCP en stdio qui interroge le même index local, et peut aussi le servir en HTTP sur loopback.
Le dépôt, de l'utilisateur GitHub yjid, a été créé le 24 octobre 2026 et comptait environ 1 645 étoiles et 107 forks au 11 novembre. Il est sous licence MIT et écrit en Rust avec une interface Tauri. La version 1.0.17, publiée le 9 novembre 2026, est une version de sécurité qui a corrigé cinq problèmes signalés en privé, dont trois jugés graves.
Installer Kensaku
kensaku-cli mcp (kensaku-cli ships with each GitHub release)Kensaku vaut-il le coup ?
Kensaku offre à un agent ce que la plupart des serveurs de fichiers n'offrent pas : chercher selon ce que dit un fichier plutôt que selon son nom, dans les documents, le code et le texte des captures d'écran, à partir d'un index qu'une application de bureau tient déjà à jour. Les outils MCP sont search, regex_search, find_symbol pour les définitions tree-sitter en Rust, Python, JavaScript et TypeScript, read_snippet, health_check et index_state. Tous sont en lecture seule. Un outil reindex existe, mais il est masqué et désactivé tant que vous ne définissez pas mcp_allow_reindex dans la configuration, et il ne s'exécute jamais en HTTP.
Les réponses sont pensées pour une fenêtre de contexte. Les extraits de recherche sont limités à 100 caractères, les pages renvoient 10 résultats par défaut et s'arrêtent à 50, et read_snippet renvoie au plus 1 024 tokens centrés sur la première correspondance plutôt qu'un fichier entier. Selon les benchmarks du projet, une recherche par nom sur 100 000 fichiers prend en moyenne 18 ms sous Windows 11 avec les threads par défaut, et les métadonnées de ces fichiers occupent 12,2 Mo. Le langage de requête (type:pdf, modified:7d, re:"...") passe tel quel par l'outil search.
Le hic : l'âge. Le dépôt a été créé le 24 octobre 2026, et la 1.0.17 du 9 novembre a corrigé cinq avis de sécurité, dont des restrictions de racine pour l'agent contournables via les périmètres de recherche et find_symbol, un read_snippet qui lisait des fichiers exclus jamais indexés, et un programme de mise à jour Linux qui acceptait un répertoire de préparation appartenant à un attaquant. Les avoir corrigés vite et publié les avis est bon signe ; trouver trois failles graves dans la frontière de l'agent au cours des deux premières semaines montre que cette frontière est encore en construction. Les builds publiés ne sont pas signés sous macOS ni sous Windows.
L'exposition à l'injection de prompt, c'est l'index lui-même. Tout texte présent dans un dossier surveillé, y compris des PDF téléchargés et des captures d'autres personnes, peut revenir à l'agent dans un extrait. La documentation indique que le contenu des fichiers est renvoyé comme des données, jamais comme des instructions, mais c'est une étiquette sur la sortie, pas un filtre qui s'impose au modèle. Les fichiers d'identifiants comme .pem et .key, les dossiers comme .ssh et .aws et les fichiers .env sont refusés par défaut, et agent_scoped_roots limite ce que voit un agent aux dossiers choisis ; quiconque pointe un agent vers un répertoire personnel devrait le définir.
Là où il fait la différence
Un développeur backend sur la piste d'un échec de déploiement de la semaine dernière
Retrouver la ligne de log et la capture de l'erreur sans se souvenir des noms de fichiers
Demandez à l'agent de chercher le texte de l'erreur avec modified:7d ; Kensaku renvoie des correspondances dans les fichiers de log et les captures passées à l'OCR, avec leurs chemins, et read_snippet récupère les lignes autour. Gratuit ; l'application de bureau a déjà construit l'index.
Une consultante avec des années de PDF et de présentations clients sur son portable
Rassembler toutes les propositions qui mentionnent un modèle tarifaire précis
Réglez agent_scoped_roots sur le dossier clients, puis faites lancer par l'agent une recherche de contenu filtrée sur type:pdf et résumer les résultats à partir des extraits. Rien ne quitte la machine, hormis ce que voit le fournisseur de modèle de l'agent.
Un ingénieur qui découvre un grand dépôt multilingue
Trouver où une fonction ou une struct est définie dans plusieurs projets
Utilisez find_symbol avec un filtre de langage pour obtenir le chemin, la plage de lignes et la signature, puis n'ouvrez que ces fichiers. Plus rapide qu'un grep complet sur un répertoire personnel, et limité à 200 fichiers analysés par appel.
Avant de vous engager
- Mise en route
- Téléchargez le paquet de l'application pour votre plateforme depuis les releases GitHub (non signé, attendez-vous donc à une alerte SmartScreen ou Gatekeeper), choisissez dossiers et exclusions au premier lancement, puis pointez un client MCP vers kensaku-cli mcp. Dans Settings, Agents, l'application peut écrire l'entrée pour Claude Desktop, Claude Code et Cursor avec une sauvegarde .bak.
- Intégrations
- Six outils visibles : search, regex_search, find_symbol, read_snippet, health_check et index_state, plus un reindex optionnel. Stdio par défaut ; kensaku-cli serve ajoute MCP Streamable HTTP sur le port loopback 8765 avec un jeton bearer.
- Données et confidentialité
- Lit l'index des dossiers que vous choisissez, qui contient noms de fichiers et texte extrait ; les outils ne peuvent pas modifier de fichiers. Pas de télémétrie ; le trafic sortant se limite à une vérification de mise à jour et au téléchargement de paquets de modèles ou d'OCR. Le mode HTTP ouvre un port loopback avec un jeton stocké dans <config>/http.token. Le texte indexé est une entrée non fiable pour l'agent. Cinq avis (dont trois graves) ont été corrigés dans la 1.0.17.
- Coût à grande échelle
- Gratuit. Le coût est local : un premier index d'environ 101 000 fichiers variés a pris 184 s avec un pic de 183 Mo lors de l'essai de référence du projet sous Linux.
- Limites
- Environ 16 issues ouvertes. Le mode exhaustif plafonne à 10 000 résultats par parcours ; find_symbol couvre quatre langages ; les scans JPEG 2000, fax et JBIG2 ne sont pas décodés ; la recherche visuelle est un téléchargement bêta hors des résultats. Windows est la plateforme la plus testée en conditions réelles.
Les points forts
- Cherche dans le texte des documents, l'OCR et le sens, pas seulement les noms
- Outils en lecture seule ; reindex désactivé par défaut
- Extraits limités en tokens et pagination
- Ni compte, ni télémétrie, ni recherche dans le cloud
Les points faibles
- Cinq avis de sécurité corrigés dès les premières semaines
- Builds non signés sous macOS et Windows
- Le texte indexé peut porter une injection de prompt jusqu'à l'agent
- La recherche visuelle ne fait pas encore partie des résultats
Idéal pour
Développeurs et travailleurs du savoir qui veulent que Claude ou Cursor retrouvent des fichiers sur leur propre machine par leur contenu, et qui limiteront l'agent à des dossiers choisis.
Alternatives à Kensaku
Kensaku : questions fréquentes
- Kensaku vaut-il le coup ?
- Un moyen rapide de laisser un agent retrouver par leur contenu les fichiers de votre propre disque, issu d'un projet d'à peine trois semaines dont la première version de sécurité vient tout juste de sortir. Nous lui donnons 3.7 sur 5.
- Combien coûte Kensaku ?
- Gratuit et open source (MIT). Pas d'offre payante, de compte ni de service cloud.
- Quels sont les inconvénients de Kensaku ?
- Cinq avis de sécurité corrigés dès les premières semaines; builds non signés sous macOS et Windows; le texte indexé peut porter une injection de prompt jusqu'à l'agent; la recherche visuelle ne fait pas encore partie des résultats.
- À qui s’adresse Kensaku ?
- Développeurs et travailleurs du savoir qui veulent que Claude ou Cursor retrouvent des fichiers sur leur propre machine par leur contenu, et qui limiteront l'agent à des dossiers choisis.
- Combien coûte Kensaku pour une équipe ou en production ?
- Gratuit. Le coût est local : un premier index d'environ 101 000 fichiers variés a pris 184 s avec un pic de 183 Mo lors de l'essai de référence du projet sous Linux.
- Kensaku est-il sûr pour les données de l’entreprise ?
- Lit l'index des dossiers que vous choisissez, qui contient noms de fichiers et texte extrait ; les outils ne peuvent pas modifier de fichiers. Pas de télémétrie ; le trafic sortant se limite à une vérification de mise à jour et au téléchargement de paquets de modèles ou d'OCR. Le mode HTTP ouvre un port loopback avec un jeton stocké dans <config>/http.token. Le texte indexé est une entrée non fiable pour l'agent. Cinq avis (dont trois graves) ont été corrigés dans la 1.0.17.
- Quelles sont les meilleures alternatives à Kensaku ?
- Les alternatives les plus proches que nous avons testées sont Filesystem (reference server), Zvec-Grep (zg) et Paperless-NGX MCP Server.
Réponses vérifiées le 11 nov. 2026.