Aller au contenu
ReviewRamble

La lettre hebdomadaire

L’IA, évaluée, dans votre boîte mail.

  • Les nouveaux tests d’outils, de modèles, de serveurs MCP et de dépôts, avec le verdict en premier
  • Les prix et les notes revérifiés quand quelque chose change
  • Les nouvelles analyses dès leur publication

Modèles, agents, serveurs MCP et les outils qui méritent vraiment votre temps.

Un e-mail par semaine. Désinscrivez-vous avec le lien présent dans chaque lettre. Comment nous utilisons votre e-mail

brain.md

La petite CLI de MindMux et quatre skills d'agent qui gardent les décisions et contraintes d'un projet en pages Markdown dans le dépôt.

Avis de ReviewRamble editors · Mis à jour

Voir sur GitHub Open source

Partager cette page :XLinkedInFacebookRedditWhatsAppE-mail

Notre note

3.4/5

brain.md est une façon soignée de faire noter à un agent pourquoi une décision a été prise, et il ne fait guère plus qu'un dossier de documentation bien tenu avec des règles plus strictes.

Qu’est-ce que brain.md ?

brain.md est une convention doublée d'un outil pour consigner ce qu'un agent de code ne devrait pas oublier d'un projet. brain init ajoute un fichier de protocole BRAIN.md, un dossier brain/ et un bloc balisé dans CLAUDE.md et AGENTS.md qui explique à tout agent comment s'en servir. Chaque page relève de l'une de six catégories, comme decision, concept ou reference, porte un résumé courant réécrivable et une chronologie de preuves où l'on ne fait qu'ajouter, et toute écriture passe par la CLI brain pour que le format reste valide.

Quatre skills le font tourner : brain-setup prépare et branche un projet, brain-bootstrap rédige les premières pages à partir du code, de la documentation et du git log ou en vous interrogeant, brain-page est le manuel de lecture et d'écriture, et brain-ingest intègre une conversation ou un document au brain. Des hooks SessionStart optionnels pour Claude Code et Codex remettent à l'agent l'index des pages au début de chaque session.

La CLI est un script Node.js sans dépendance, publié sur npm sous le nom @mindmux/brain-md, sous licence Apache 2.0, par MindMux. Le dépôt a été créé en juin 2026 ; la v0.4.2 est sortie le 13 novembre 2026.

brain.md vaut-il le coup ?

L'idée est saine et l'ambition honnête. brain.md ne cherche pas à enregistrer tout ce que fait un agent ; il lui demande de ne consigner que ce qui comptera encore dans six mois et ne se déduit pas du code, et de laisser une trace quand cette compréhension change. update-truth réécrit le résumé d'une page et ajoute une entrée à la chronologie en une seule écriture, si bien qu'une décision renversée laisse une trace au lieu de disparaître.

Il n'y a pas beaucoup de code derrière, et c'est à la fois l'attrait et la limite. La CLI et l'installeur totalisent environ 1 750 lignes de JavaScript sans dépendance, plus quatre fichiers de skill et des tests. Il n'y a pas de commande de recherche : l'agent liste les pages par identifiant, titre et catégorie et lit celles qui semblent pertinentes, ce qui fonctionne avec quelques dizaines de pages et se complique avec des centaines. La capture dépend du respect de BRAIN.md par l'agent ; rien n'enregistre une session automatiquement, contrairement à claude-mem ou ai-memory, donc un agent occupé peut tout simplement oublier.

Les hooks restent sobres. Le hook SessionStart de Codex n'envoie que l'index des pages, plafonné à 8 KiB, dispose de cinq secondes et se termine sans bruit si la CLI échoue ; il exige Node 18 et un shell POSIX, ce qui exclut Windows natif. Les hooks contiennent un chemin absolu et doivent être réinstallés quand un projet est déplacé. Comme le brain vit dans le dépôt, quiconque y a accès peut le lire, ce qui est le but, et aussi une raison de ne pas y mettre de secrets.

L'adoption est modeste : 722 étoiles, neuf contributeurs et 814 téléchargements npm sur les 30 jours précédant le 19 novembre. Pour une équipe qui tient déjà des registres de décisions d'architecture, brain.md ajoute un format que les agents ont pour consigne d'entretenir ; pour une équipe qui ne consigne rien, c'est un premier pas peu coûteux.

Là où il fait la différence

  • Une équipe de trois personnes dont les agents rouvrent sans cesse des choix de conception déjà tranchés

    Faire lire à l'agent les décisions passées avant qu'il propose une autre approche

    Lancez brain init, puis la skill brain-bootstrap pour rédiger des pages de décision depuis le git log ; le bloc de CLAUDE.md demande à l'agent de charger les pages utiles au début de chaque tâche. Gratuit, et les pages apparaissent en revue de code.

  • Un développeur qui alterne entre Claude Code et Codex sur un même dépôt

    Donner aux deux agents le même savoir sur le projet au démarrage de session

    Installez les hooks SessionStart des deux avec brain install-hooks et brain install-hooks --agent codex ; chaque session reçoit l'index des pages, jusqu'à 8 KiB, et lit les pages complètes à la demande.

Avant de vous engager

Mise en route
npm install -g @mindmux/brain-md, puis brain setup -y pour copier les skills dans chaque agent détecté, puis brain init dans le projet. Exige Node 18 ou plus récent.
Intégrations
Skills d'agent pour Claude Code, Codex, Cursor et Pi ; hooks SessionStart pour Claude Code et Codex ; tout agent qui lit AGENTS.md ou CLAUDE.md peut suivre le protocole. Pas de serveur MCP.
Données et confidentialité
Les pages sont du Markdown dans le dossier brain/ du dépôt, ou dans un chemin fixé par brainRoot ; la CLI n'envoie rien nulle part. Tout ce que l'agent écrit est visible par quiconque a accès au dépôt.
Limites
Ni recherche ni embeddings ; l'instantané du hook Codex est plafonné à 8 KiB et cinq secondes ; les hooks contiennent un chemin absolu et doivent être réinstallés après un déplacement ; les shells Windows natifs ne sont pas pris en charge.

Les points forts

  • Markdown simple dans le dépôt, versionné avec le code
  • La chronologie en ajout seul garde la raison de chaque changement de décision
  • CLI sans dépendance ; rien à héberger
  • La skill d'amorçage rédige les premières pages depuis le code et le git log

Les points faibles

  • Pas de recherche ; les agents parcourent une liste de pages
  • La capture dépend de l'agent qui pense à écrire
  • Les hooks exigent un shell POSIX ; Windows natif non pris en charge
  • Petit projet : 9 contributeurs, 814 téléchargements npm par mois

Idéal pour

Les petites équipes qui veulent que Claude Code ou Codex consignent décisions et contraintes d'architecture dans le dépôt, dans un format qu'une personne peut relire dans une pull request.

Alternatives à brain.md

brain.md : questions fréquentes

brain.md vaut-il le coup ?
brain.md est une façon soignée de faire noter à un agent pourquoi une décision a été prise, et il ne fait guère plus qu'un dossier de documentation bien tenu avec des règles plus strictes. Nous lui donnons 3.4 sur 5.
Combien coûte brain.md ?
Gratuit sous licence Apache 2.0 ; ni service ni compte.
Quels sont les inconvénients de brain.md ?
Pas de recherche ; les agents parcourent une liste de pages; la capture dépend de l'agent qui pense à écrire; les hooks exigent un shell POSIX ; Windows natif non pris en charge; petit projet : 9 contributeurs, 814 téléchargements npm par mois.
À qui s’adresse brain.md ?
Les petites équipes qui veulent que Claude Code ou Codex consignent décisions et contraintes d'architecture dans le dépôt, dans un format qu'une personne peut relire dans une pull request.
brain.md est-il sûr pour les données de l’entreprise ?
Les pages sont du Markdown dans le dossier brain/ du dépôt, ou dans un chemin fixé par brainRoot ; la CLI n'envoie rien nulle part. Tout ce que l'agent écrit est visible par quiconque a accès au dépôt.
Quelles sont les meilleures alternatives à brain.md ?
Les alternatives les plus proches que nous avons testées sont ai-memory, claude-obsidian et OpenWiki.

Réponses vérifiées le 20 nov. 2026.