Moxie Docs
jackalope.digital · Programmation
Moxie Docs est un service de documentation hébergé pour les dépôts GitHub. Vous connectez un dépôt, il indexe votre code dans une base de connaissances interrogeable, garde cette base synchronisée à chaque fusion et sert le même contexte aux agents de codage IA via MCP. Il exécute aussi des contrôles à chaque PR qui signalent les lacunes de documentation et ouvre chaque vendredi des PR de nettoyage, pour que le wiki ne se dégrade pas en silence. Et pourquoi s'encombrer d'une documentation de code automatisée ? Parce que la version manuelle finit toujours par perdre.
À propos de Moxie Docs
Qu'est-ce que Moxie Docs
Moxie Docs est une documentation de code automatisée pour les équipes qui livrent sur GitHub. Il lit votre dépôt, rédige une documentation avec citation des sources sur le fonctionnement réel du code et garde ces documents à jour au fil des changements. Au lieu d'un wiki statique que personne ne met à jour, vous obtenez un ensemble vivant de documents revérifiés à chaque fusion. C'est l'argument, et à en juger par les pages du produit, il tient plutôt bien.
L'idée plus ambitieuse, c'est le contexte pour les agents IA. Des agents de codage comme Cursor, Claude Code, Codex et Windsurf font de moins bonnes modifications quand ils doivent deviner vos conventions et votre architecture. Moxie Docs expose la documentation, les conventions et les lacunes de votre dépôt via le Model Context Protocol, si bien qu'un agent récupère un contexte compact et précis au lieu de brûler des tokens en lectures exploratoires. Une seule commande de configuration après avoir connecté GitHub, et c'est fini. Aucun empaquetage manuel de contexte.
Les limites comptent aussi. Il ne fonctionne qu'avec GitHub, donc si votre équipe vit sur GitLab ou Bitbucket, ce n'est pas pour vous. C'est un service hébergé, ce qui veut dire que votre code et vos documents résident sur l'infrastructure de quelqu'un d'autre, ce que certaines équipes refusent tout simplement. Et le tarif au-delà de l'offre gratuite n'est pas publié clairement, donc les acheteurs attentifs au budget devraient confirmer les coûts auprès du fournisseur avant de s'engager.
Pour commencer
- Inscrivez-vous sur moxiedocs.com avec votre compte GitHub. L'offre gratuite couvre un dépôt et ne demande pas de carte.
- Connectez le dépôt que vous voulez documenter et accordez l'accès en lecture pour que le service puisse l'indexer.
- Laissez la première indexation se terminer. Moxie Docs génère des notes d'architecture, des frontières entre modules et des flux entre fichiers avec des diagrammes Mermaid, tous cités jusqu'à la source.
- Branchez le serveur MCP à votre agent de codage avec la commande de configuration fournie, pour que les agents interrogent la documentation en direct au lieu de deviner.
- Activez les contrôles sur les PR et, si vous le souhaitez, rendez-les obligatoires dans la protection des branches, pour que les lacunes de documentation soient signalées à chaque pull request.
Informations sur le produit
Aperçu des tarifs, des plateformes compatibles et des performances de Moxie Docs.
Idéal pour
Les utilisateurs, tâches et cas d'usage où cet outil convient le mieux.
Utilisateurs
- Ingénieurs backend et plateforme
- Équipes d'ingénierie qui intègrent des nouvelles recrues
- Développeurs qui utilisent des agents de codage IA
Tâches
- Générer de la documentation de code
- Garder la documentation synchronisée avec le code
- Alimenter les agents IA en contexte du dépôt
- Auditer la documentation sur les pull requests
Cas d'usage
- Un dépôt qui bouge vite, où le README a dérivé il y a des mois sans que personne ne le remarque
- Intégrer un nouvel ingénieur qui doit vite s'orienter
- Une équipe qui utilise déjà des agents de codage IA qui n'arrêtent pas de rater les conventions du projet.
- L'entretien hebdomadaire de la documentation
Fonctionnalités clés
Documentation de code automatisée
Moxie Docs indexe votre dépôt GitHub et rédige une documentation de code automatisée et interrogeable qui couvre l'architecture, les frontières entre modules, les conventions et les flux entre fichiers. Chaque affirmation cite le fichier source d'où elle vient, donc vous pouvez la vérifier au lieu de la croire. Les documents sont revérifiés à chaque fusion au lieu d'être écrits une fois puis oubliés.
Contexte MCP pour les agents de codage IA
Le service expose la documentation, les conventions et les lacunes ouvertes de votre dépôt via le Model Context Protocol. Des agents comme Cursor, Claude Code, Codex et Windsurf peuvent alors récupérer un contexte compact au lieu de faire des lectures exploratoires, ce qui veut dire moins de tokens gaspillés et des modifications qui respectent la manière dont votre projet est réellement construit. La configuration tient en une commande après avoir connecté GitHub.
Détection de dérive de la documentation
Comme les documents sont contrôlés à chaque fusion, Moxie Docs peut signaler l'instant précis où ils décrochent par rapport au code. Au lieu d'un wiki qui pourrit en silence, vous recevez un signal indiquant qu'un document précis ne correspond plus à ce qui a été livré. C'est la différence entre repérer la dérive un vendredi et la repérer six mois plus tard. C'est dans cet écart que meurt la confiance dans la documentation.
Contrôles de documentation sur les PR
À chaque pull request, Moxie Docs lance un contrôle indicatif qui signale les lacunes de documentation, les ruptures de convention et les descriptions de PR qui sautent votre modèle. Vous pouvez le laisser indicatif ou l'exiger dans la protection des branches quand vous voulez une barrière ferme. Les équipes qui considèrent la documentation comme faisant partie de la définition du terminé en tirent le plus.
PR de nettoyage du vendredi
Chaque semaine, le service peut ouvrir un pull request regroupant des corrections de documentation issues de l'activité GitHub. Vous le révisez comme n'importe quel autre PR, vous gardez le bon et vous écarter ce qui ne l'est pas. Il transforme la corvée vague « mettre à jour la doc » en changement concret et révisable.
Bases de connaissances publiques hébergées
Moxie Docs héberge des bases de connaissances publiques, ce qui convient aux projets open source qui veulent une documentation visible sans tenir un site de docs à la main. C'est aussi un moyen propre de publier des notes d'architecture pour des contributeurs externes.
Avantages et inconvénients
Avantages
- Les documents citent la source, donc vous pouvez vérifier les affirmations au lieu de les croire
- La documentation vivante est revérifiée à chaque fusion, là où la plupart des wikis échouent
- Le contexte MCP réduit les lectures exploratoires des agents IA, économise des tokens et améliore les modifications
- L'offre gratuite couvre un dépôt sans carte, faible risque pour essayer
- Les PR de nettoyage du vendredi transforment l'entretien de la documentation en flux de révision normal
Inconvénients
- GitHub uniquement, donc les équipes sur GitLab et Bitbucket ne peuvent pas l'utiliser
- Un service hébergé, donc votre code et vos documents reposent sur une infrastructure tierce, ce que certaines équipes n'autorisent pas
- Le tarif au-delà de l'offre gratuite n'est pas publié clairement, donc il faudra demander avant de budgéter
- Il documente ce que fait votre code, pas si la conception est bonne, donc il ne remplace pas la revue d'architecture
Questions fréquentes
Il se connecte à votre dépôt GitHub, génère une documentation sourcée sur le code, la garde à jour à chaque fusion et sert ce contexte aux agents de codage IA via MCP. Voyez-le comme une documentation automatisée et toujours fraîche, avec une API conviviale pour agents par-dessus.
Contenus associés
Découvrez des outils, des compétences et des articles liés à Moxie Docs.
Alternatives à Moxie Docs
Base Code
Base44 (Wix) · Programmation · ProductivitéBase Code est un environnement de développement cloud partagé signé Base44. Votre équipe décrit des modifications sur un dépôt GitHub dans le chat, les vérifie en aperçu et les renvoie sous forme de pull requests.
Google EmbeddingGemma 2
Google DeepMind · Rédaction · Image · ProgrammationGoogle EmbeddingGemma 2 est un modèle ouvert de 740 millions de paramètres qui transforme texte, code, images, audio et images vidéo en vecteurs d'un même espace de 768 dimensions, sur un téléphone ou un ordinateur portable.
GitGlow
GitGlow · Programmation · ProductivitéGitGlow est un client Git de bureau qui place votre code et les modifications de vos agents IA dans une même revue, pour savoir ce qui quitte votre machine avant de livrer.