Zum Inhalt springen
ReviewRamble

Der wöchentliche Brief

KI im Test, in deinem Postfach.

  • Neue Tests von Tools, Modellen, MCP-Servern und Repos, mit dem Urteil vorneweg
  • Neu geprüfte Preise und Bewertungen, wenn sich etwas ändert
  • Neue Analysen, sobald sie erscheinen

Modelle, Agenten, MCP-Server und die Tools, die deine Zeit wirklich wert sind.

Eine E-Mail pro Woche. Abmelden kannst du dich über den Link in jedem Brief. Wie wir deine E-Mail-Adresse nutzen

brain.md

MindMux' kleine CLI und vier Agenten-Skills, die Entscheidungen und Vorgaben eines Projekts als Markdown-Seiten im Repo festhalten.

Getestet von ReviewRamble editors · Aktualisiert

Auf GitHub ansehen Open Source

Diese Seite teilen:XLinkedInFacebookRedditWhatsAppE-Mail

Unsere Bewertung

3.4/5

brain.md ist eine ordentliche Methode, einen Agenten festhalten zu lassen, warum eine Entscheidung fiel, und leistet kaum mehr als ein gut gepflegter Doku-Ordner mit strengeren Regeln.

Was ist brain.md?

brain.md ist eine Konvention plus ein Werkzeug, um festzuhalten, was ein Coding-Agent über ein Projekt nicht vergessen sollte. brain init legt eine Protokolldatei BRAIN.md, einen Ordner brain/ und einen markierten Block in CLAUDE.md und AGENTS.md an, der jedem Agenten erklärt, wie er es nutzt. Jede Seite hat eine von sechs Kategorien, etwa decision, concept oder reference, eine überschreibbare aktuelle Zusammenfassung und eine Zeitleiste mit Belegen, an die nur angehängt wird, und jeder Schreibvorgang läuft über die CLI brain, damit das Format gültig bleibt.

Vier Skills treiben es an: brain-setup richtet ein Projekt ein und verdrahtet es, brain-bootstrap entwirft die ersten Seiten aus Code, Doku und git log oder durch ein Interview mit dir, brain-page ist das Handbuch zum Lesen und Schreiben, und brain-ingest arbeitet eine Unterhaltung oder ein Dokument in das Brain ein. Optionale SessionStart-Hooks für Claude Code und Codex geben dem Agenten zu Beginn jeder Sitzung den Seitenindex.

Die CLI ist ein Node.js-Skript ohne Abhängigkeiten, auf npm als @mindmux/brain-md unter der Apache-2.0-Lizenz von MindMux veröffentlicht. Das Repository wurde im Juni 2026 angelegt; v0.4.2 erschien am 13. November 2026.

Lohnt sich brain.md?

Die Idee ist vernünftig und der Anspruch ehrlich. brain.md versucht nicht, alles aufzuzeichnen, was ein Agent tut; es bittet ihn, nur festzuhalten, was in sechs Monaten noch zählt und sich nicht aus dem Code ablesen lässt, und eine Spur zu hinterlassen, wenn sich dieses Verständnis ändert. update-truth überschreibt die Zusammenfassung einer Seite und hängt in einem einzigen Schreibvorgang einen Zeitleisteneintrag an, sodass eine revidierte Entscheidung einen Beleg hinterlässt, statt zu verschwinden.

Viel Code steckt nicht dahinter, und das ist zugleich Reiz und Grenze. CLI und Installer kommen auf rund 1.750 Zeilen JavaScript ohne Abhängigkeiten, dazu vier Skill-Dateien und Tests. Einen Suchbefehl gibt es nicht: Der Agent listet Seiten nach ID, Titel und Kategorie und liest die, die relevant wirken, was bei Dutzenden Seiten funktioniert und bei Hunderten schwieriger wird. Die Erfassung hängt davon ab, dass der Agent BRAIN.md befolgt; anders als bei claude-mem oder ai-memory zeichnet nichts eine Sitzung automatisch auf, ein beschäftigter Agent kann es also einfach vergessen.

Die Hooks sind zurückhaltend. Der SessionStart-Hook für Codex schickt nur den Seitenindex, begrenzt auf 8 KiB, hat fünf Sekunden Laufzeit und beendet sich still, wenn die CLI scheitert; er braucht Node 18 und eine POSIX-Shell, natives Windows fällt also weg. Hooks enthalten einen absoluten Pfad und müssen nach dem Verschieben eines Projekts neu installiert werden. Weil das Brain im Repository liegt, kann es jeder mit Zugriff auf das Repo lesen, was genau der Sinn ist und zugleich ein Grund, Geheimnisse draußen zu lassen.

Die Verbreitung ist bescheiden: 722 Sterne, neun Mitwirkende und 814 npm-Downloads in den 30 Tagen bis zum 19. November. Für ein Team, das schon Architekturentscheidungen dokumentiert, fügt brain.md ein Format hinzu, dessen Pflege Agenten aufgetragen wird; für eines, das gar nichts festhält, ist es ein günstiger erster Schritt.

Wo es sich lohnt

  • Ein dreiköpfiges Team, dessen Agenten längst geklärte Designfragen immer wieder aufrollen

    Den Agenten frühere Entscheidungen lesen lassen, bevor er einen neuen Ansatz vorschlägt

    brain init ausführen, dann den Skill brain-bootstrap, um Entscheidungsseiten aus dem git log zu entwerfen; der Block in CLAUDE.md weist den Agenten an, zu Beginn jeder Aufgabe passende Seiten zu laden. Kostenlos, und die Seiten erscheinen im Code-Review.

  • Ein Entwickler, der in einem Repository zwischen Claude Code und Codex wechselt

    Beiden Agenten zu Sitzungsbeginn dasselbe Projektwissen geben

    Die SessionStart-Hooks für beide mit brain install-hooks und brain install-hooks --agent codex installieren; jede Sitzung bekommt den Seitenindex, bis zu 8 KiB, und liest ganze Seiten bei Bedarf.

Bevor du dich festlegst

Einrichtung
npm install -g @mindmux/brain-md, dann brain setup -y, um die Skills in jeden erkannten Agenten zu kopieren, dann brain init im Projekt. Braucht Node 18 oder neuer.
Integrationen
Agenten-Skills für Claude Code, Codex, Cursor und Pi; SessionStart-Hooks für Claude Code und Codex; jeder Agent, der AGENTS.md oder CLAUDE.md liest, kann dem Protokoll folgen. Kein MCP-Server.
Daten und Datenschutz
Seiten sind Markdown im Ordner brain/ des Repositorys oder unter einem per brainRoot gesetzten Pfad; die CLI schickt nichts irgendwohin. Was der Agent schreibt, sieht jeder mit Zugriff auf das Repository.
Grenzen
Keine Suche und keine Embeddings; der Snapshot des Codex-Hooks ist auf 8 KiB und fünf Sekunden begrenzt; Hooks enthalten einen absoluten Pfad und müssen nach einem Umzug neu installiert werden; native Windows-Shells werden nicht unterstützt.

Was gut ist

  • Schlichtes Markdown im Repo, mit dem Code versioniert
  • Die Zeitleiste zum Anhängen bewahrt den Grund jeder geänderten Entscheidung
  • CLI ohne Abhängigkeiten; nichts zu hosten
  • Der Bootstrap-Skill entwirft erste Seiten aus Code und git log

Was nicht

  • Keine Suche; Agenten blättern durch eine Seitenliste
  • Die Erfassung hängt davon ab, dass der Agent ans Schreiben denkt
  • Hooks brauchen eine POSIX-Shell; natives Windows nicht unterstützt
  • Kleines Projekt: 9 Mitwirkende, 814 npm-Downloads im Monat

Am besten für

Kleine Teams, die Claude Code oder Codex Architekturentscheidungen und Vorgaben im Repository festhalten lassen wollen, in einem Format, das ein Mensch im Pull Request prüfen kann.

Alternativen zu brain.md

brain.md: häufige Fragen

Lohnt sich brain.md?
brain.md ist eine ordentliche Methode, einen Agenten festhalten zu lassen, warum eine Entscheidung fiel, und leistet kaum mehr als ein gut gepflegter Doku-Ordner mit strengeren Regeln. Wir bewerten es mit 3.4 von 5.
Was kostet brain.md?
Kostenlos unter der Apache-2.0-Lizenz; kein Dienst und kein Konto.
Welche Nachteile hat brain.md?
Keine Suche; Agenten blättern durch eine Seitenliste; Die Erfassung hängt davon ab, dass der Agent ans Schreiben denkt; Hooks brauchen eine POSIX-Shell; natives Windows nicht unterstützt; Kleines Projekt: 9 Mitwirkende, 814 npm-Downloads im Monat.
Für wen eignet sich brain.md?
Kleine Teams, die Claude Code oder Codex Architekturentscheidungen und Vorgaben im Repository festhalten lassen wollen, in einem Format, das ein Mensch im Pull Request prüfen kann.
Ist brain.md sicher für Firmendaten?
Seiten sind Markdown im Ordner brain/ des Repositorys oder unter einem per brainRoot gesetzten Pfad; die CLI schickt nichts irgendwohin. Was der Agent schreibt, sieht jeder mit Zugriff auf das Repository.
Was sind die besten Alternativen zu brain.md?
Die nächsten Alternativen, die wir getestet haben, sind ai-memory, claude-obsidian und OpenWiki.

Antworten geprüft am 20. Nov. 2026.