OpenWiki — un CLI pour créer et gérer une documentation destinée aux agents pour les bases de code

 (github.com/langchain-ai)
14 points par xguru 1 일 전 | 3 commentaires | Partager sur WhatsApp
  • Outil de documentation conçu spécifiquement pour les agents, afin de créer et maintenir des wikis pour des bases de code ou de la mémoire dédiée à un objectif
  • Importe des sources de connaissances locales via des connecteurs intégrés ou des dépôts Git, puis les unifie dans un wiki local
  • Propose deux modes
    • Mode Personal : construit un wiki de cerveau personnel dans ~/.openwiki/wiki à partir de sources comme des dépôts locaux, Gmail, Notion, Web Search, Hacker News, X, etc.
    • Mode Code : génère dans openwiki/ la documentation du dépôt pour la base de code actuelle
  • Mise à jour automatique de la documentation via l’intégration CI : fournit des exemples de workflows pour GitHub Actions/GitLab CI afin de créer automatiquement des PR/merge requests de mise à jour de la documentation
  • Produit des bundles Google Open Knowledge Format (OKF) v0.1 dans les deux modes ; les documents conceptuels disposent d’un YAML front matter avec un champ type, et les relations sont représentées par des liens Markdown
  • À chaque exécution de code, maintient AGENTS.md et CLAUDE.md à la racine du dépôt, afin d’inciter les agents de codage à consulter le wiki lors de la recherche de contexte
    • Si les fichiers existent déjà, seul le bloc <!-- OPENWIKI:START -->…<!-- OPENWIKI:END --> est mis à jour, le reste étant conservé
  • Prend en charge, via des connecteurs locaux, la collecte depuis des dépôts Git, Notion, Gmail, X, Web Search et Hacker News ; un même connecteur peut être configuré en plusieurs instances
  • Prise en charge de nombreux fournisseurs d’inférence : OpenAI, OpenRouter, Gemini (AI Studio), Gemini Enterprise (Vertex AI), Nebius Token Factory, Fireworks, Baseten, NVIDIA NIM, compatibles OpenAI, AWS Bedrock, Anthropic
    • La valeur par défaut à l’onboarding est gpt-5.6-terra d’OpenAI ; des méthodes d’authentification propres à chaque fournisseur sont proposées, comme la connexion ChatGPT, les identifiants IAM ou Google ADC
  • Collecte par défaut une télémétrie anonyme (au niveau des commandes, résultats, fournisseurs et noms de connecteurs), mais ne collecte pas le contenu des fichiers, les identifiants, les prompts, les sorties de modèle ni l’IP ; désactivation possible avec OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1
  • Installation avec npm install -g openwiki
  • Licence MIT

À lire aussi

3 commentaires

 
laeyoung 1 일 전

J’ai voulu l’essayer, mais le fait que la télémétrie anonyme soit collectée par défaut (au niveau des commandes/résultats/noms de fournisseurs/connecteurs) est un peu décevant. On peut la désactiver, certes, mais j’ai l’impression que beaucoup de gens l’utiliseront telle quelle par défaut sans trop regarder le contenu.
 
superl3 23 시간 전

Il est possible de la désactiver avec OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1
mais vous ne leur faites pas confiance ?
 
laeyoung 20 시간 전

On peut le désactiver, mais comme le comportement par défaut est l’opt-in, j’ai l’impression que beaucoup de gens l’utiliseront tel quel par défaut.

Si j’imagine le recommander à un collègue ou à un ami, je dirais plutôt « OpenWiki est bien, essaie-le », et pas « OpenWiki est bien, mais tu peux désactiver la collecte de données avec OPENWIKI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1, donc active ça avant de l’utiliser », hélas.

Cela dit, j’avais compris commande et résultat comme Prompt et Output. Mais en relisant le texte original, ce n’est pas ça. Alors peut-être que ça va ?!