OpenWiki : un CLI pour des wikis Markdown maintenus par des agents
OpenWiki est une CLI qui écrit et gère la documentation des agents pour votre base de code.
En bref
- De quoi s’agit-il ?
- OpenWiki génère et met à jour un wiki Markdown lié à partir de votre dépôt ou de sources connectées, avec un visualiseur interactif pour les humains.
- À qui s’adresse-t-il ?
- OpenWiki est un CLI sous licence MIT qui maintient un wiki Markdown synchronisé avec votre base de code ou vos sources personnelles, en utilisant un agent pour écrire et mettre à jour la documentation, et offre un visualiseur local pour l'exploration.
- Puis-je l’utiliser commercialement ?
- Oui. MIT est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 1 jour.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un wiki Markdown auto-maintenu
OpenWiki est un outil en ligne de commande qui génère et maintient un wiki pour une base de code ou des connaissances personnelles. Un agent lit les sources que vous indiquez, synthétise un wiki Markdown lié et le met à jour à mesure que vos sources changent. La sortie est du Markdown simple que vous possédez et versionnez avec votre code. Il fonctionne en deux modes : le mode code documente le dépôt actuel et écrit dans openwiki/ de ce dépôt ; le mode personnel documente les sources connectées et écrit dans ~/.openwiki/wiki. Le README indique que le wiki est conçu pour que les agents le lisent comme mémoire, et il comprend un visualiseur interactif pour les humains.
Installation, initialisation et mises à jour planifiées
Installez le CLI globalement avec npm install -g openwiki. La première exécution de openwiki --init vous guide dans le choix d'un fournisseur, d'une clé et d'un modèle, puis écrit les documents dans openwiki/. Pour des mises à jour continues, le README fournit des exemples de fichiers de workflow pour GitHub Actions, GitLab CI et Bitbucket Pipelines, que vous copiez dans votre dépôt et planifiez. Sous Windows, le README note que bun n'est pas recommandé pour l'installation car il peut retomber sur la compilation de la dépendance native better-sqlite3, nécessitant Visual Studio Build Tools.
Explorer le wiki avec le visualiseur
Le visualiseur est un graphe de nœuds interactif avec un lecteur Markdown côte à côte, lancé avec openwiki visualize. Il sert le wiki sur une adresse de boucle locale (127.0.0.1) et ne l'expose jamais sur le réseau. Le serveur prend automatiquement en compte les modifications apportées aux fichiers du wiki. Vous pouvez passer un chemin de répertoire, choisir un port avec --port (défaut 4321), ou ignorer l'ouverture du navigateur avec --no-open. Le README note que la page charge ses bibliothèques de graphes, Markdown et diagrammes à partir d'un CDN public, donc une connexion Internet est requise même si le serveur est local.
Sources et connecteurs
En mode personnel, OpenWiki ingère des connaissances depuis les dépôts git locaux, Notion, Gmail, X/Twitter, la recherche Web et Hacker News. Chaque connecteur écrit des données brutes et des manifestes sous ~/.openwiki/connectors/<connecteur>/raw/, puis des exécutions d'agent synthétisent le wiki sous ~/.openwiki/wiki/. Vous pouvez configurer le même connecteur plusieurs fois comme instances distinctes. L'authentification est gérée avec openwiki auth <fournisseur>, qui exécute un flux OAuth dans le navigateur local et stocke les jetons dans ~/.openwiki/.env. Slack utilise un tunnel ngrok pour OAuth. Le connecteur LangSmith fonctionne en mode code à la place, extrayant les traces LangSmith récentes (appels d'outils, résultats, latence) pour les projets sélectionnés via le SDK officiel, et écrit un openwiki/.langsmith.json commité qui nomme les espaces de travail et les projets mais jamais la clé API.
Format de sortie et validation des diagrammes
OpenWiki émet des bundles Google Open Knowledge Format (OKF) v0.1. Les documents de concept portent un front matter YAML avec un type non vide ; les autres champs sont facultatifs. index.md et log.md sont des documents réservés, et l'index racine déclare okf_version: "0.1". Le wiki comprend des diagrammes Mermaid pour les flux de séquence, les modèles ER, les diagrammes d'état et les organigrammes. Après chaque exécution, chaque bloc mermaid est validé ; un diagramme qui échoue à la validation est converti sur place en un bloc de texte brut avec un court commentaire, et la prochaine mise à jour le répare. Pour une validation faisant autorité correspondant au rendu de GitHub, vous pouvez installer le parseur Mermaid à côté d'OpenWiki.
Fournisseurs de modèles et identifiants
Le défaut d'intégration est OpenAI avec gpt-5.6-terra. Douze fournisseurs de modèles sont listés : OpenAI, Anthropic, Gemini (AI Studio), Gemini Enterprise (Vertex AI), AWS Bedrock, GitHub Copilot, OpenRouter, Nebius/Fireworks/Baseten/NVIDIA NIM, et tout point de terminaison compatible OpenAI (LiteLLM, Ollama, LM Studio, passerelles). Chaque fournisseur a des options de modèle prédéfinies et prend en charge les ID de modèle personnalisés. Les identifiants sont stockés dans ~/.openwiki/.env. Le README donne une configuration détaillée pour Bedrock (identifiants IAM, résolution de région), Gemini Enterprise (Google ADC, pas de clé API), la connexion OpenAI ChatGPT (OAuth via le backend Codex) et les points de terminaison compatibles OpenAI. Les URL de base alternatives et l'épinglage du fournisseur OpenRouter sont également documentés.
Confidentialité, télémétrie et licence
OpenWiki conserve la documentation générée en Markdown simple que vous possédez, et maintient AGENTS.md et CLAUDE.md à la racine du dépôt, en ne réécrivant que son propre bloc. INSTRUCTIONS.md est rédigé par l'utilisateur et n'est jamais réécrit. Les exécutions sans opération sont gratuites : l'outil prend un instantané du répertoire de sortie et n'enregistre de nouvelles métadonnées que lorsque quelque chose a réellement changé. La télémétrie est anonyme et agrégée, activée par défaut, et peut être désactivée avec OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1. Le README énumère ce qui est collecté (commande, résultat, catégorie d'erreur grossière, mode cérébral lors de la configuration) et ce qui n'est jamais collecté (contenus de fichiers, identifiants, invites, sortie, chemins, URL). Le projet est sous licence MIT ; le texte de licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies, et déclare que le logiciel est fourni "tel quel" sans garantie d'aucune sorte.
Conclusion éditoriale
OpenWiki est un CLI sous licence MIT qui maintient un wiki Markdown synchronisé avec votre base de code ou vos sources personnelles, en utilisant un agent pour écrire et mettre à jour la documentation, et offre un visualiseur local pour l'exploration.
Notes de la communauté