OpenKnowledge transforme un dossier Markdown en base de connaissances intelligente pour les agents IA
J'utilise des fichiers Markdown simples pour mes notes de travail et mes spécifications architecturales dans les dépôts depuis un certain temps. D'un côté, c'est pratique : tout est stocké localement, versionné avec git, et s'ouvre dans n'importe quel IDE. D'un autre côté, rédiger de longs textes en Markdown brut avec des balises et des tableaux bruts devient rapidement fastidieux. Vous voulez un véritable éditeur visuel au niveau de Notion ou Google Docs, mais sans être lié au cloud de quelqu'un d'autre et aux formats de données propriétaires.
La situation s'est compliquée davantage lorsque Claude Code, Cursor et d'autres agents en ligne de commande sont devenus partie intégrante de mon flux de travail quotidien. Vous devez constamment leur fournir du contexte, leur demander de réécrire une section ou de mettre à jour la documentation en fonction de la base de code.
Récemment, l'équipe Inkeep a publié OpenKnowledge en open source. En essence, les auteurs ont tenté de combiner un éditeur de documents visuel avec un environnement de travail pour les agents de réseaux neuronaux.
Sous le capot
OpenKnowledge ouvre n'importe quel dossier local sur le disque contenant des fichiers .md ou .mdx. Cela pourrait être la racine de votre dépôt, un dossier avec de la documentation technique, ou même un ancien coffre-fort Obsidian. Il n'y a pas de bases de données propriétaires ici : l'application lit les fichiers depuis le disque et enregistre les modifications au format brut.
Dans le même temps, vous obtenez un WYSIWYG complet. Les titres, listes, liens, tableaux interactifs et blocs HTML intégrés sont formatés à la volée pendant que vous tapez. Vos yeux ne trébuchent pas sur la syntaxe de balisage, et le fichier résultant reste du Markdown standard.
La fonctionnalité principale est cachée sur le côté. L'éditeur dispose d'un panneau intégré pour interagir avec les modèles de langage via le protocole Model Context Protocol (MCP) et les outils CLI locaux. L'application peut fonctionner aux côtés de Claude, Codex, OpenCode, Pi et d'autres agents.
Fonctionnalités principales de l'éditeur
Si vous décomposez le projet en composants, vous obtenez un ensemble intéressant de fonctionnalités :
-
WYSIWYG honnête sans compromis. Vous modifiez le document dans une vue visuelle pratique, et l'application enregistre du Markdown ou MDX valide à la volée. Les composants visuels, un graphe des liens entre les pages (wiki links), les onglets et la recherche rapide de fichiers sont tous pris en charge.
-
Édition collaborative avec l'IA. L'agent s'ouvre dans la moitié inférieure de l'écran et voit la structure de vos documents. Vous pouvez demander au modèle de créer un plan architectural, de trouver des incohérences dans une spécification ou de réécrire une section tout en regardant les modifications en temps réel.
-
Protocoles d'intégration prêts à l'emploi. Au premier lancement, l'utilitaire détecte automatiquement les agents installés sur votre système (Claude Desktop, Cursor, Claude Code) et configure les serveurs MCP et les compétences de recherche pour votre base de connaissances locale.
-
Synchronisation et collaboration d'équipe via Git. Le projet n'impose pas d'abonnements d'équipe payants. La synchronisation entre les appareils et les collègues repose sur Git et GitHub simples.
Comment installer et exécuter
Le projet propose deux options d'utilisation : une application de bureau prête à l'emploi ou une interface web locale qui s'exécute via Node.js.
Les builds de bureau pour macOS (Apple Silicon), Windows 10+ et Linux (deb/rpm) sont disponibles sur le site officiel du projet et dans les versions du dépôt.
Si vous travaillez sur un serveur, sur un Mac Intel ou si vous préférez simplement lancer des outils via la console, un client CLI est disponible. Il nécessite Node.js version 24 ou supérieure :
# Устанавливаем CLI глобально
npm install -g @inkeep/open-knowledge
# Переходим в папку с документами или проектом
cd your-project
# Инициализируем проект и подключаем найденные AI-агенты
ok init
# Запускаем локальный веб-сервер и открываем браузер
ok start --open
La commande ok init parcourt le système, vérifie les assistants installés et configure la connexion entre eux et l'éditeur.
Où cela s'avère utile en pratique
Les auteurs positionnent l'outil pour plusieurs tâches dès le départ.
Le premier scénario évident est la documentation technique et les spécifications architecturales. Lorsque vous devez décrire une conception de système, rédiger une RFC ou préparer un rapport, l'interface visuelle fait gagner du temps. Dans le même temps, l'agent peut lire les fichiers de code voisins via MCP en parallèle et suggérer des signatures de fonctions précises.
Le deuxième scénario est une base de connaissances personnelle ou « deuxième cerveau ». Si vous maintenez des notes sur le concept LLM Wiki (dont Andrej Karpathy parle souvent), où un agent aide à organiser et lier des pensées disparates, OpenKnowledge endosse le rôle de l'interface vers cette base. La recherche en texte intégral et sémantique aide à récupérer rapidement les fragments nécessaires via des prompts.
En conclusion
OpenKnowledge ressemble à une tentative réussie de sortir l'édition Markdown des conditions spartiates des éditeurs de texte brut sans enfermer les utilisateurs dans des services cloud fermés.
Le code est distribué sous licence GPLv3, écrit en TypeScript, et sa communauté est en pleine croissance. L'inconvénient est l'exigence de Node.js 24+ pour la version web, ce qui peut nécessiter la mise à jour de l'environnement sur les machines plus anciennes. Mais si vous travaillez fréquemment avec des spécifications locales et souhaitez donner à vos assistants IA un accès pratique aux documents, cela vaut définitivement la peine d'essayer le projet.
Projets similaires