Qu’est-ce que OpenWiki ?
OpenWiki est un projet LangChain qui fait explorer un dépôt par un agent de code, lui fait écrire un wiki Markdown lié dans un dossier openwiki/, puis le tient à jour. Chaque affirmation factuelle est enregistrée comme un Grounded Claim qui pointe vers une preuve versionnée dans le code source, comme un fichier et une plage de lignes ; une mise à jour ne réécrit donc que les pages dont la preuve a changé, et une mise à jour sans changement ne fait aucun appel au modèle.
Il fonctionne de deux façons : à l'intérieur d'un agent de code que vous utilisez déjà (Codex, Claude Code, OpenCode, Cursor, GitHub Copilot CLI, Kiro, IBM Bob, Antigravity, Oh My Pi ou Pi), avec la session de modèle de cet agent, ou comme CLI autonome sur son propre agent de documentation Deep Agents avec quatorze fournisseurs de modèles. Il maintient un bloc dans AGENTS.md, expose des outils locaux de recherche et de lecture via MCP, relie des wikis de plusieurs dépôts en espaces de travail et écrit l'Open Knowledge Format v0.2 de Google.
Le dépôt a été créé le 22 juin 2026, est sous licence MIT et compte environ 17 600 étoiles sur GitHub. Le paquet npm en est à la 0.7.2 (9 octobre 2026) et a été téléchargé environ 66 000 fois la dernière semaine d'octobre.
OpenWiki vaut-il le coup ?
OpenWiki résout le problème qui coule la plupart des documentations générées : elles pourrissent, et personne ne sait quelles parties. En rattachant chaque fait à une preuve versionnée dans le code, il peut savoir au passage suivant qu'une affirmation sur la gestion des nouvelles tentatives cite des lignes qui ont depuis bougé, et ne renvoyer que cette page au modèle. Mettre à jour un dépôt inchangé ne coûte rien, car la vérification a lieu avant tout appel au modèle. Les pages sont enregistrées une à une, si bien qu'une exécution interrompue reprend au lieu de recommencer.
Le modèle d'intégration est l'avantage pratique. Lancé dans Claude Code ou Codex, il emprunte la session authentifiée et les outils de l'agent : pas de deuxième clé d'API ni de deuxième facture à gérer ; l'agent fait la recherche et l'écriture pendant qu'OpenWiki gère la file d'attente, la tenue des affirmations et les index finaux. Ses outils MCP de recherche et de lecture sont locaux, en lecture seule et n'appellent aucun modèle, et les instructions gérées demandent aux agents de chercher pour les questions précises plutôt que de charger le wiki au début de chaque tâche. Des tâches planifiées GitHub Actions, GitLab et Bitbucket ouvrent une pull request de documentation quand le wiki change.
Les réglages par défaut méritent un examen. La télémétrie est activée : un seul événement par init ou update avec la commande, le résultat et, à la configuration, les noms du fournisseur et des connecteurs, jamais de code ni de prompts ; OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1 la désactive. Le visualiseur de graphe charge ses bibliothèques depuis un CDN public, il ne fonctionne donc pas hors ligne. Un .openwikiignore empêche la lecture de chemins, mais le README précise que l'agent peut encore déduire une zone ignorée à partir des tests ou des messages de commit.
Les limites sont celles d'un projet de quatre mois qui avance vite : version 0.7.2, environ 208 issues et pull requests ouvertes, et un ancrage des affirmations qui ne couvre pour l'instant que le code du dépôt, pas les connecteurs de wiki personnel (Notion, Gmail, Slack, X) ni les traces LangSmith. Face à Repomix, qui emballe un dépôt dans un seul prompt à chaque fois, OpenWiki coûte une génération complète au départ et la rentabilise à chaque question ultérieure et à chaque mise à jour incrémentale.
Là où il fait la différence
Une équipe plateforme responsable d'un plan de contrôle, d'un plan de données et d'un dépôt d'infrastructure
Permettre aux agents de répondre à des questions transversales sans charger les trois bases de code
Générez un wiki dans chaque dépôt, regroupez-les avec openwiki link dans un espace de travail, et les agents cherchent dans les trois via des outils MCP locaux. Lancé via Claude Code ou Codex, il n'ajoute aucune facture de modèle au-delà de la session de l'agent.
Une responsable d'ingénierie dans une entreprise de 30 développeurs à la documentation d'intégration périmée
Garder la documentation d'architecture à jour sans y affecter quelqu'un
Ajoutez le workflow planifié GitHub Actions avec un token à permissions fines pour qu'il ouvre une pull request de documentation seule dès que des affirmations deviennent obsolètes ; les relecteurs la fusionnent comme tout autre changement. Les semaines sans changement ne font aucun appel au modèle.
Un staff engineer qui arrive sur un gros dépôt inconnu
Obtenir une carte précise de la base de code en un après-midi
Installez l'intégration Claude Code et demandez à l'agent d'initialiser OpenWiki à partir du code source et des tests, puis ouvrez openwiki visualize pour un graphe à côté d'un lecteur Markdown. Attendez-vous à ce que la première génération consomme les tokens d'une session d'agent complète.
Avant de vous engager
- Mise en route
- npm install -g openwiki (Node 22.22.0+), openwiki integrations install claude (ou codex, cursor et d'autres), redémarrez l'agent et demandez-lui d'initialiser le wiki. En autonome : openwiki --init vous guide pour le fournisseur, la clé et le modèle.
- Intégrations
- Dix agents de code hôtes ; quatorze fournisseurs pour la CLI autonome, dont OpenAI (gpt-5.6-terra par défaut), Anthropic, Bedrock, Vertex, Copilot et des endpoints compatibles OpenAI comme Ollama ; modèles de CI pour GitHub, GitLab et Bitbucket ; connecteurs Notion, Gmail, Slack, X, recherche web et Hacker News pour un wiki personnel.
- Données et confidentialité
- Le wiki et les affirmations sont de simples fichiers dans votre dépôt ; les clés sont dans ~/.openwiki/.env. La télémétrie envoie par défaut un événement anonyme par init ou update ; OPENWIKI_TELEMETRY_DISABLED=1 la désactive. Le contenu du dépôt part chez le fournisseur de modèles ou l'agent hôte que vous utilisez. Licence MIT.
- Coût à grande échelle
- Logiciel gratuit. La première génération d'un gros dépôt est l'étape coûteuse ; les exécutions natives peuvent documenter jusqu'à 8 pages en parallèle, et les mises à jour suivantes ne paient que pour les pages dont la preuve a changé. Via un agent de code hôte, le coût est inclus dans cet abonnement.
- Limites
- Environ 208 issues et pull requests ouvertes en 0.7.2 ; les exécutions pilotées par l'hôte sont séquentielles et ne couvrent que les wikis de code ; les passerelles uniquement en streaming peuvent renvoyer un wiki vide si le streaming n'est pas forcé ; un solde OpenRouter bas peut provoquer des erreurs 402 sans plafond de sortie.
Les points forts
- Les Grounded Claims rattachent chaque fait à des lignes de code versionnées
- Les mises à jour sans changement sautent entièrement les appels au modèle
- Fonctionne dans dix agents de code avec leur session existante
- Recherche MCP locale et en lecture seule entre dépôts liés
Les points faibles
- Télémétrie activée par défaut
- Le visualiseur exige un CDN public, donc pas de consultation hors ligne
- L'ancrage des affirmations ne couvre que le code, pas les connecteurs
- Avant la 1.0, avec environ 208 issues et PR ouvertes
Idéal pour
Les équipes dont les agents de code redécouvrent sans cesse la même base de code et qui veulent un wiki qui se met à jour lui-même par pull requests au lieu de dériver.
Alternatives à OpenWiki
OpenWiki : questions fréquentes
- OpenWiki vaut-il le coup ?
- OpenWiki est le premier outil de documentation écrite par des agents qui sait lesquelles de ses propres phrases sont devenues obsolètes, et c'est ce qui rend la documentation générée digne d'être conservée. Nous lui donnons 4.2 sur 5.
- Combien coûte OpenWiki ?
- Gratuit et open source (MIT). Vous payez directement votre fournisseur de modèles.
- Quels sont les inconvénients de OpenWiki ?
- Télémétrie activée par défaut; le visualiseur exige un CDN public, donc pas de consultation hors ligne; l'ancrage des affirmations ne couvre que le code, pas les connecteurs; avant la 1.0, avec environ 208 issues et PR ouvertes.
- À qui s’adresse OpenWiki ?
- Les équipes dont les agents de code redécouvrent sans cesse la même base de code et qui veulent un wiki qui se met à jour lui-même par pull requests au lieu de dériver.
- Combien coûte OpenWiki pour une équipe ou en production ?
- Logiciel gratuit. La première génération d'un gros dépôt est l'étape coûteuse ; les exécutions natives peuvent documenter jusqu'à 8 pages en parallèle, et les mises à jour suivantes ne paient que pour les pages dont la preuve a changé. Via un agent de code hôte, le coût est inclus dans cet abonnement.
- OpenWiki est-il sûr pour les données de l’entreprise ?
- Le wiki et les affirmations sont de simples fichiers dans votre dépôt ; les clés sont dans ~/.openwiki/.env. La télémétrie envoie par défaut un événement anonyme par init ou update ; OPENWIKI_TELEMETRY_DISABLED=1 la désactive. Le contenu du dépôt part chez le fournisseur de modèles ou l'agent hôte que vous utilisez. Licence MIT.
- Quelles sont les meilleures alternatives à OpenWiki ?
- Les alternatives les plus proches que nous avons testées sont Repomix, Graphify, code2prompt et claude-mem.
Réponses vérifiées le 31 oct. 2026.