cookbook-brain

Gib deinen Agenten ein Gedächtnis, das dir gehört.

cookbook-brain speichert, was deine KI-Agenten lernen, als einfache Markdown-Dateien in einem Git-Repository auf deiner Festplatte. Claude Code, Codex oder jeder MCP-Client kann sich erinnern, abrufen und darauf aufbauen: ein Gehirn, all deine Agenten. Dein Claude und dein Codex wissen endlich dieselben Dinge und können sich sogar gegenseitig Arbeit übergeben. Jede Notiz sagt, wer sie geschrieben hat – Mensch oder welcher Agent. Nichts wird jemals überschrieben. Und Notizen verdienen sich Vertrauen auf die einzige Art, die etwas bedeutet: indem sie richtig waren, als echte Arbeit von ihnen abhing.

Öffne den Ordner in Obsidian und du siehst einfache Notizen, denn das ist alles, was es ist.

Schnellstart

npx cookbook-brain init             # creates ./brain with a schema note
npx cookbook-brain harvest          # propose notes distilled from your recent Claude Code sessions
npx cookbook-brain harvest --apply  # write the proposals the refuter kept
claude mcp add brain -- npx cookbook-brain serve

Dein Gehirn startet voll: Bevor deine erste Agentensitzung jemals verbindet, liest harvest deine letzten lokalen Claude Code-Transkripte und destilliert die Entscheidungen, Fallstricke und Konventionen, die bereits darin stecken, in attribuierte Notizen (siehe „Harvest“ unten; es schlägt nur vor, bis du --apply sagst).

Sag dann deinem Agenten: „Denk dran, dass die Staging-DB nachts zurückgesetzt wird“ und es wird gespeichert, attribuiert und in jeder zukünftigen Sitzung abgerufen. Das ist der ganze Kreislauf.

Andere Befehle:

npx cookbook-brain log           # recent notes, newest first
npx cookbook-brain credit <id>   # credit notes whose facts held up in real work
npx cookbook-brain tasks         # open and claimed tasks, with age
npx cookbook-brain doctor        # validate every note, link, chain, and task
npx cookbook-brain index         # generate INDEX.md, a wikilinked view of the brain
npx cookbook-brain web           # read-only local viewer at http://127.0.0.1:4321
npx cookbook-brain install-hook  # every session harvests itself when it closes (report-only)

Das Gehirn-Verzeichnis wird aufgelöst über das --dir-Flag, dann die Umgebungsvariable BRAIN_DIR, dann ./brain. Die menschliche Attribution kommt von BRAIN_HUMAN, fallback auf deinen OS-Benutzernamen. Erfordert Node 20 oder neuer.

Related MCP server: clawmem-mcp-server

Warum Dateien

Das Gedächtnis deiner Agenten sollte nicht in der Vektordatenbank eines anderen leben. Dateien bedeuten, dass du jede Erinnerung lesen, jede Änderung diffen, um 2 Uhr morgens grep-en, mit git sichern und jederzeit gehen kannst, indem du deinen Ordner behältst. Anbieter ändern ihre Richtlinien; Markdown tut das nicht.

Und nein, es gibt keine Vektordatenbank darunter, und zwar aus drei konkreten Gründen. Embeddings brauchen einen API-Key und Netzwerkaufrufe, und dieses Tool macht keine: nichts verlässt deine Festplatte. Ein Vektorindex ist undurchsichtig: du kannst ihn nicht grep-en, diffen oder sehen, warum er das zurückgegeben hat, was er getan hat. Und im Maßstab eines persönlichen Gehirns (hunderte Notizen, nicht Millionen von Dokumenten) funktioniert die reine Textsuche plus der Link-Graph genauso gut. Vektoren verdienen ihre Komplexität im Korpus-Maßstab. Dies ist kein Korpus; es ist ein Gehirn.

Das Format

Eine Notiz pro Datei. Frontmatter trägt die Fakten über die Tatsache:

---
id: 01J8ZQ4X2E5N9GVHBK3W7T1MCD
type: decision
title: Poll interval is 30s, not 10
aliases: ["Poll interval is 30s, not 10"]
author:
  human: diego
  agent: claude-code
created: 2026-08-18T17:20:00.000Z
supersedes: null
source: "https://status.example.com/limits"
credits: 3
last_credited: 2026-08-20T09:30:00.000Z
---
Free-tier endpoints rate-limit hard. At 10s we tripped limits on 3 of 8
targets. 30s stays under every limit tested. Related:
[[Unknown check state renders as degraded]]

Notizen sind typisiert (decision, gotcha, convention, note, open_thread, task) und einem Menschen zugeschrieben, plus, wenn ein Agent sie geschrieben hat, dem Label des Agenten. Das optionale source-Feld zitiert, woher eine Tatsache stammt (eine URL, ein Dateipfad, eine Ticket-ID); zitierte Erinnerung ist prüfbare Erinnerung, und sie verdient eine höhere Vertrauensobergrenze. Jede Notiz trägt auch eine aliases-Liste, die ihren eigenen Titel enthält; Dateinamen sind datums-slugifiziert, und dieser Alias ist es, der Obsidian erlaubt, [[Title]]-Wikilinks zur richtigen Datei aufzulösen (siehe „Verwendung mit Obsidian“ unten). Wikilinks sind der Graph. Der Abruf gibt eine Notiz MIT ihren Backlinks und den Zeilen um jede Erwähnung zurück, sodass Agenten verbundenen Kontext erhalten, keine isolierten Fakten. Der Abruf trägt auch jede aktive convention-Notiz wörtlich mit, unabhängig von der Abfrage: stehende Regeln fahren mit, sodass Agenten sie auf alle Arbeiten anwenden, nicht nur auf Arbeiten, die danach gesucht haben. Dateinamen sind <date>--<slug-of-title>.md, sodass das Verzeichnis wie ein Tagebuch aussieht.

Niemals überschreiben

Das Aktualisieren einer Notiz erstellt eine neue Notiz, die die alte ersetzt. Die alte Datei bleibt bestehen, als ersetzt markiert. Zwei Gründe, beide auf die harte Tour gelernt: Jede KI-Neuschreibung verliert stillschweigend ein wenig Bedeutung, und du kannst eine Erinnerung nicht debuggen ohne ihre Geschichte. Das Git-Log deines Gehirns ist sein Prüfpfad.

Notiztexte sind für immer append-only; genau zwei Zähler dürfen an Ort und Stelle in eine vorhandene Datei gestempelt werden: credits und last_credited, geschrieben, wenn Arbeit, die sich auf eine Notiz stützte, nachweislich abgeschlossen wurde. Dieses Credit-Paar ist die zweite erlaubte Mutation, neben dem superseded_by-Stempel. Aufgabennotizen tragen einen dritten Stempelsatz, nur bei Aufgaben-Notizen: status, claimed_by, result und abandon_reason. Nichts anderes an einer vorhandenen Datei wird jemals berührt.

Vertrauen: Vertrauen wird verdient, nicht behauptet

Jeder Abruf trägt eine Vertrauensbewertung und eine Stufe (proven / standing / verify). Die Formel ist öffentlich und absichtlich langweilig:

score = clamp(cap - 0.10 + 0.05 * min(credits, 3) - staleness, 0.20, cap)

• Die Herkunft setzt die Obergrenze. Eine von einem Menschen geschriebene Notiz begrenzt bei 0,95. Eine Agentennotiz, die eine Quelle zitiert (das source-Frontmatter-Feld, eine source:-Zeile oder eine URL im Text): 0,85. Eine unbelegte Agentenbehauptung: 0,60. Keine noch so häufige Wiederholung hebt eine Notiz über ihre Obergrenze.

• Credits erhöhen sie. Eine frische, nicht kreditierte Notiz liegt 0,10 unter ihrer Obergrenze. Wenn Arbeit, die eine Notiz abgerufen hat, nachweislich erfolgreich ist, kreditiere die Notiz (ein CLI-Aufruf, oder lass deinen Agenten es bei Abschluss tun); jeder Credit fügt 0,05 hinzu, und drei Credits holen die Obergrenze zurück.

• Stille senkt sie. Veralterung subtrahiert 0,05 pro volle 90 Tage seit last_credited (oder seit created, falls nie kreditiert), bis zu 0,15. Eine Notiz, die seit Monaten niemand kreditiert hat, verfällt in Richtung „vor dem Vertrauen überprüfen“.

Bewertungen werden auf zwei Dezimalstellen gerundet. Stufen: proven bedeutet mindestens einmal kreditiert UND Bewertung 0,80 oder höher, sodass nur Notizen, auf die echte abgeschlossene Arbeit angewiesen war, als bewiesen gelten können. standing (0,60 oder höher) kann man vertrauen. Alles andere ist verify: überprüfe es, bevor du darauf aufbaust.

Dies ist der Teil, den kein anderes Gedächtnissystem mitliefert: Erinnerung, die nicht nur beantwortet „Was haben wir gesagt?“, sondern auch „War das jemals tatsächlich richtig, als es darauf ankam?“

Aufgaben: Deine Agenten können sich gegenseitig Arbeit übergeben

Eine Aufgabe ist nur eine weitere Notiz (Typ: task) mit einem Status und einem Bearbeiter:

"assign my codex a task: read docs/brief.md and draft the FAQ"

Dein Claude schreibt die Aufgabennotiz. Wenn deine Codex-Sitzung das nächste Mal startet und das Gehirn abruft, liegt die offene Aufgabe, die an sie adressiert ist, im open_tasks-Abschnitt der Antwort. Sie beansprucht sie, erledigt die Arbeit und schließt sie ab, und der Abschluss ist der Punkt, an dem sich der Kreislauf schließt: Der abschließende Agent zeichnet auf, auf welche Notizen er sich gestützt hat (helped_note_ids), und diese Notizen werden kreditiert. So verdient sich das Gedächtnis sein Vertrauen, ohne dass du jemals einen Buchhaltungsbefehl ausführen musst.

Und wenn sich eine beanspruchte Aufgabe als zu schwierig für einen Agenten erweist (fehlender Zugriff, wiederholte Fehlschläge), gibt er die Aufgabe auf, anstatt darauf sitzen zu bleiben: Die Aufgabe geht mit dem Grund, der in abandon_reason festgehalten wird, zurück in den offenen Status, sichtbar für den Zuweiser und den nächsten Ansprucher. Sichtbarkeit von Fehlschlägen ist ein Feature; eine Aufgabe, die still verrottet, ist schlimmer als eine Aufgabe, die laut zurückgegeben wird. Der Grund wird gelöscht, wenn jemand die Aufgabe als nächstes beansprucht.

Ehrliche Mechanik: Es gibt keinen Hintergrundprozess. Zuweisung bedeutet, dass die Notiz im Ordner wartet, bis die nächste Sitzung dieses Agenten sie aufnimmt. Deine Agenten koordinieren sich durch das Gehirn, wie ein Team sich durch ein Whiteboard koordiniert: Nichts bewegt sich, bis jemand vorbeigeht und es liest. Für immer aktives Beanspruchen, Live-Übergaben zwischen Menschen und Belege mit echter Kostenattribution ist das gehostete Produkt zuständig.

Träumen (Dreaming)

Gehirne, die nur anhäufen, verschlammen irgendwann. npx cookbook-brain dream ist der nächtliche Konsolidierungslauf: Es führt Duplikate zusammen, befördert zweimal kreditierte Gotchas zu Konventionen, markiert Widersprüche als offene Threads und benennt kollidierende Notizen um, wobei jeder Vorschlag von einem gegnerischen Widerleger überprüft wird, bevor etwas angewendet wird. Es läuft auf deinem eigenen Claude CLI unter deinem eigenen Login: cookbook-brain hält nie einen API-Key und führt selbst keine Netzwerkaufrufe durch.

npx cookbook-brain dream               # report-only: propose and review, apply nothing
npx cookbook-brain dream --apply       # execute the proposals the refuter kept
npx cookbook-brain dream --apply --commit  # then git commit the brain directory (only paths under it)
npx cookbook-brain dream --json        # machine-readable report on stdout (report file still written)
npx cookbook-brain dream --dry-digest  # print exactly what would be sent to the model, then exit
npx cookbook-brain dream --model <id>  # pick the model; default is your claude setting

Wie ein Traum funktioniert, der Reihe nach:

1. Hygiene-Scan, kein Modell. Ein deterministischer Durchlauf sammelt doppelte aktive Titel, ersetzte Notizen, die noch von aktiven Wikilinks referenziert werden, und veraltete, unbewiesene Notizen (verify-Stufe, älter als 90 Tage). Diese Funde speisen den nächsten Schritt.

2. Vorschlagender. Ein claude -p-Aufruf sieht eine kompakte Zusammenfassung deiner aktiven Notizen (id, Typ, Titel, Credits, Alter, erste 280 Zeichen jedes Textes) und kann nur Operationen aus einer geschlossenen Menge vorschlagen: merge, promote, flag_contradiction, retitle_for_collision. Führe zuerst --dry-digest aus, wenn du genau lesen möchtest, was an das Modell geht; der Widerleger-Aufruf sendet zusätzlich den vollständigen Text jeder Notiz, die ein Vorschlag berührt.

3. Widerleger. Ein zweiter claude -p-Aufruf mit frischem Kontext und ohne Erinnerung an den Vorschlag überprüft jeden Vorschlag anhand des vollständigen Textes seiner Quellnotizen und muss mit keep oder reject samt Begründung antworten. Ein Vorschlag, dessen Urteil nicht geparst werden kann, wird standardmäßig abgelehnt, niemals stillschweigend behalten. Wenn der Widerleger-Aufruf selbst fehlschlägt oder Müll zurückgibt, wird der gesamte Traum als refuter: absent markiert und nichts wird angewendet, selbst mit --apply. Der Bericht unterscheidet immer zwischen „keine Einwände“ und „der Prüfer ist nie erschienen“. Der Widerleger-Prompt ist auf 24.000 Zeichen begrenzt: Wenn Vorschläge plus ihre Quellnotizen ihn überlaufen lassen, werden die größten Vorschläge aus der Überprüfung entfernt, als „nicht überprüft: zu groß“ aufgezeichnet und niemals angewendet, denn nicht überprüfte Vorschläge werden niemals angewendet.

4. Anwenden, nur wenn du darum gebeten hast. Die Voreinstellung ist nur Bericht. Mit --apply werden behaltene Vorschläge reversibel ausgeführt: Eine Zusammenführung schreibt eine neue Notiz, deren consolidates-Feld die Quell-IDs auflistet und jede Quelle mit superseded_by stempelt; eine Beförderung macht dasselbe in eine Konvention; ein Widerspruch legt eine gewöhnliche open_thread-Notiz an (übersprungen, wenn ein aktiver open_thread bereits beide Notizen referenziert, sodass derselbe Konflikt nie zweimal markiert wird); eine Umbenennung ist eine einfache Ersetzung. Während des Schreibens hält die Anwendung eine brain/.lock-Datei: MCP-Schreibwerkzeuge warten sie ab, Lesevorgänge blockieren nie, und ein Lock, das älter als zehn Minuten ist, ist veraltet (eine abgestürzte Anwendung) und wird mit einer Warnung überschrieben. Einen Traum rückgängig zu machen ist git revert auf seinen Commit, denn ein Traum fügt nur Dateien hinzu und stempelt superseded_by. Füge --commit hinzu und eine erfolgreiche Anwendung committed das Gehirn-Verzeichnis für dich, wobei nur Pfade darunter berührt werden.

Jeder Traum schreibt einen Bericht nach brain/dreams/DREAM_<date>.md (ein Unterverzeichnis, das der Notizen-Scanner nie liest): die Zusammenfassungsstatistiken, die Hygiene-Funde, jeder Vorschlag mit seiner Begründung, jedes Widerleger-Urteil mit seinem Grund, die obligatorische Zeile refuter: ran oder refuter: absent, was angewendet wurde und wie man es rückgängig macht.

Eine Eigenschaft, die beachtenswert ist: Notizen, die ein Traum schreibt, sind verfasst als { human: you, agent: "dream" }, und die bloße-Agenten-Herkunftsobergrenze gilt. Das Gehirn misstraut seinen eigenen Träumen, bis Arbeit sie beweist. Eine geträumte, zusammengeführte Notiz beginnt mit niedrigem Vertrauen wie jede andere unbelegte Agentenbehauptung und verdient sich nur ihren Weg nach oben, indem sie richtig ist, wenn echte Arbeit von ihr abhängt.

Nächtlich, wenn du möchtest

Träume sind dafür ausgelegt, während du schläfst zu laufen. Eine einfache Crontab-Zeile erledigt das:

15 3 * * * cd /path/to/your/project && npx cookbook-brain dream >> brain/dreams/cron.log 2>&1

Lasse --apply weg und lies die Berichte bei einem Kaffee, oder füge es hinzu, sobald du dem Geschmack deines Widerlegers vertraust. In beiden Fällen committe das Gehirn danach, sodass jeder Traum ein rückgängig machbarer Commit ist; --apply --commit erledigt diesen Commit für dich.

Harvest: Dein Gehirn startet voll

Ein neues Gehirn sollte nicht leer beginnen, während Wochen deiner echten Entscheidungen in lokalen Sitzungstranskripten sitzen. npx cookbook-brain harvest liest deine letzten Claude Code-Sitzungen, destilliert sie in atomare Notizen und lässt jeden Vorschlag am selben gegnerischen Widerleger vorbei, der auch Träume überprüft. So bootet ein Gehirn am ersten Tag und so füllt es sich nach einer schweren Woche auf.

npx cookbook-brain harvest                  # report-only: propose notes from the last 7 days
npx cookbook-brain harvest --days 30        # scan further back
npx cookbook-brain harvest --project myapp  # only sessions whose working directory basename matches
npx cookbook-brain harvest --apply          # write the notes the refuter kept
npx cookbook-brain harvest --session <id> --since-last  # one session, only messages newer than its watermark
npx cookbook-brain harvest --dry-digest     # print exactly what would be sent to the model, then exit
npx cookbook-brain harvest --json           # machine-readable report on stdout (report file still written)
npx cookbook-brain harvest --sessions <path> --model <id>   # override the transcripts root and the model

Gerade Antworten auf die Fragen, die du dir stellen solltest:

• Was es liest. Lokale Claude Code-Transkripte unter ~/.claude/projects (überschreibbar mit --sessions), aus den letzten N Tagen, und ja: es liest den NACHRICHTENINHALT – die eigenen Nachrichten des Menschen und die wichtigsten Schlussfolgerungen des Assistenten – denn das Destillieren von Inhalten ist der ganze Zweck. Das Zeitfenster wird pro NACHRICHTEN-Zeitstempel angewendet, sodass eine Sitzungsdatei, die seit Monaten aktiv ist, nur ihre Nachrichten innerhalb des Fensters beiträgt, niemals ihre gesamte Historie. Werkzeugverkehr, Unteragent-Transkripte und die eigenen claude -p-Ausführungen des Werkzeugs (Harvest- und Dream-Aufrufe, erkannt an ihrem Prompt-Marker) werden übersprungen. Dies ist die bewusste Gegenteil von reinen Metadaten-Werkzeugen; es wird hier genannt, damit Sie es nie überraschend entdecken.

• Wohin es sendet. Kompakte Zusammenfassungen pro Sitzung gehen an Ihre eigene angemeldete claude-CLI, dasselbe Werkzeug, das die Sitzungen ursprünglich erstellt hat. Keine API-Schlüssel, keine anderen Netzwerkaufrufe, nichts verlässt Ihren Rechner auf einem Weg, den Ihr claude-Login nicht bereits nutzt. --dry-digest gibt den exakten ausgehenden Prompt aus.

• Was es schreibt. Nichts, standardmäßig. Ein Bericht unter brain/dreams/HARVEST_<date>.md listet jeden Vorschlag, jeden Deduplizierungs-Übersprung (Fakten, die das Gehirn bereits kennt) und jedes Urteil des Widerlegers auf, einschließlich der obligatorischen Zeile refuter: ran oder refuter: absent; eine nicht überprüfte Ernte wendet nichts an, selbst mit --apply. Nur --apply schreibt Notizen, und eine angewandte Ernte fügt nur neue Dateien hinzu, sodass das Rückgängigmachen mit git revert oder dem Löschen der aufgelisteten Dateien möglich ist.

• Die Misstrauenseigenschaft. Geerntete Notizen sind verfasst als { human: you, agent: "harvest" }, und jeder Textkörper endet mit einer source:-Zeile, die auf die Sitzung mit dem tatsächlichen Nachrichtenzeitraum des verdauten Ausschnitts verweist (z. B. source: session 2026-08-15, project cookbook-app oder source: session 2026-08-12 to 2026-08-18, project phonestack für eine langlebige Sitzung). Dieses Zitat erhält die Vertrauensobergrenze für zitierten Agenten (0,85) durch die normale Quellenerkennung, ohne Sonderbehandlung: Das Gehirn vertraut seinem eigenen Bootstrap mehr als einer bloßen Behauptung, aber weniger als Ihnen, bis echte Arbeit die Notizen aufwertet.

Zwei Flags machen die Ernte chirurgisch statt pauschal. --session <id> erntet genau ein Transkript (das Tagesfenster gilt weiterhin, standardmäßig mit großzügigen 2 Tagen in diesem Modus). --since-last macht die Ernte inkrementell: Es liest sitzungsbezogene Wasserzeichen aus brain/dreams/harvested.json (eine Abbildung von Sitzungs-ID auf den Zeitstempel der letzten Nachricht, die eine Ernte verdaut hat) und verdaut nur Nachrichten, die neuer als jedes Wasserzeichen sind, sodass eine Sitzungsdatei, die monatelang aktiv ist, niemals alte Inhalte erneut verdaut. Jede erfolgreiche Ernte, auch die reine Berichtsernte, aktualisiert die Wasserzeichen; ein fehlgeschlagener oder nicht parsbaren Modellaufruf aktualisiert nichts, sodass Inhalte nie stillschweigend verloren gehen. Die Datei lebt unter dreams/, der Notiz-Scanner liest sie nie, und das Löschen bedeutet nur, dass die nächste Ernte vom einfachen Tagesfenster ausgeht.

Autoharvest: Sitzungen, die sich selbst destillieren

Ein Befehl lässt jede Claude Code-Sitzung bei ihrem Schließen sich selbst ernten:

npx cookbook-brain install-hook

Das registriert einen SessionEnd-Hook in ~/.claude/settings.json, chirurgisch: Die Datei wird geparst, genau ein Eintrag wird eingefügt, jeder andere Schlüssel und Hook bleibt erhalten, und der Befehl weigert sich, überhaupt zu schreiben, wenn die Datei nicht parst. Von da an, wann immer eine Sitzung endet, liest der Hook das SessionEnd-Payload, startet einen DETACHED-Hintergrundlauf von

cookbook-brain harvest --session <that session> --since-last --json

im Arbeitsverzeichnis der Sitzung und beendet sich sofort, sodass das Schließen einer Sitzung nie verzögert wird. Das Wasserzeichen --since-last bedeutet, dass eine langlebige Sitzung nur inkrementell verdaut wird: Jedes Schließen destilliert nur das, was seit der letzten Ernte passiert ist.

Die direkten Antworten, noch einmal:

• Immer nur Bericht. Der Hook kann nicht anwenden, absichtlich und hartcodiert: Unbeaufsichtigte Schreibvorgänge in Ihr Gedächtnis brauchen zuerst Ihre Augen. Behaltene Vorschläge sammeln sich in den Berichten, und cookbook-brain log endet mit einer Zeile wie 2 harvest report(s) with unapplied keeps: review with cookbook-brain harvest --apply, wenn aktuelle Berichte behaltene, aber nicht angewandte Notizen enthalten. Überprüfen Sie sie bei einem Kaffee und wenden Sie an, wenn Sie zustimmen; deduplizieren Sie bereits bekannte Fakten, damit sie nie doppelt landen.

• Wo die Ausgabe landet. Jeder Lauf hängt seinen JSON-Bericht an ~/.cookbook-brain-autoharvest.log an, und der Markdown-Bericht landet wie jede Ernte in brain/dreams/HARVEST_<date>.md (der web-Betrachter zeigt sie ebenfalls an). Das Gehirnverzeichnis wird aus dem eigenen Arbeitsverzeichnis der Sitzung aufgelöst (./brain oder BRAIN_DIR), sodass eine Sitzung in einem Projekt ohne Gehirn nur einen höflichen Fehler protokolliert und nichts ändert.

• Der ehrliche Kostenhinweis. Ein Sitzungsschluss löst bis zu zwei Modellaufrufe (Vorschlagender und Widerleger) auf Ihrem eigenen claude-CLI-Login aus. Sie laufen im Hintergrund, sodass das Schließen sofort erfolgt, aber es sind echte Aufrufe auf Ihrem Konto. Die Abschwächungen sind strukturell: Eine Sitzung ohne neues Material nach ihrem Wasserzeichen beendet sich vor jedem Modellaufruf, und die eigenen claude -p-Ausführungen des Werkzeugs (Harvest- und Dream-Aufrufe) werden an ihrem Prompt-Marker erkannt und vollständig übersprungen, sodass Autoharvest nie rekursiv wird.

• Rückgängig machen mit einem Befehl. npx cookbook-brain uninstall-hook entfernt nur den cookbook-brain-Eintrag und lässt jede andere Einstellung und jeden Hook unberührt. Bereits laufende Sitzungen bemerken dies bei ihrem nächsten Neustart, in beide Richtungen.

Was es nicht ist

• Keine Vektordatenbank (siehe „Warum Dateien“ oben; optionale Einbettungen können später kommen und werden nie erforderlich sein).

• Nicht gehostet. Ein Gehirn, ein Besitzer, beliebig viele IHRER Agenten.

• Kein Chat-Protokoll. Es speichert atomare, bewusste Notizen, keine Transkripte; selbst harvest, das Ihre Sitzungen liest, destilliert sie in Einzelfakt-Notizen und speichert nie ein Transkript.

Kann mein Team ein Gehirn teilen?

Sie können das Repository so teilen, wie Sie jedes Repository teilen, und für zwei sorgfältige Personen funktioniert das halbwegs. Was kaputt geht, ist das, was geteiltes Gedächtnis vertrauenswürdig macht: Es gibt keine Live-Synchronisation (Sie erinnern sich an veraltete Notizen, bis jemand pullt), gleichzeitige Schreibvorgänge führen zu Merge-Konflikten, und nichts erzwingt eine Zuordnung: Jeder kann jede Datei bearbeiten, einschließlich ihrer Gutschriften. Ein Datensatz, den jeder stillschweigend umschreiben kann, ist kein Datensatz.

Erzwungene Zuordnung, Live-Synchronisation, atomare Aufgabenansprüche und Quittungen, die das Gedächtnis über ein gesamtes Team hinweg anerkennen, benötigen einen Server, den die Leute nicht umgehen können. Das ist das Produkt, das wir verkaufen: cookbook.team ist das Multiplayer-Gehirn. Dieses Repository ist das Einzelspieler-Gehirn, und es ist ehrlich gesagt exzellent in dieser Aufgabe.

cookbook-brain und Obsidian

Ihr Gehirnordner öffnet sich in Obsidian als normales Vault: Die Wikilinks leuchten auf, die Graph-Ansicht zeichnet das Wissen Ihrer Agenten, Rückverweise funktionieren einfach. Obsidian ist der beste jemals gebaute Leser für dieses Format, und Sie sollten es unbedingt auf Ihr Gehirn richten.

Was fügt dies also hinzu, was ein Obsidian-Vault plus einem der bestehenden Vault-MCP-Server nicht tut? Diese Server öffnen eine Tür: Der Agent kann Ihre Notizen lesen, bearbeiten und löschen. Dieses Werkzeug fügt die Disziplin für das hinzu, was hindurchgeht. Vault-Server lassen einen Agenten Ihre Notiz überschreiben; hier ist jede Änderung eine neue, zugeordnete Notiz, die die alte ersetzt. Vault-Notizen sind alle gleichermaßen für immer vertrauenswürdig; hier tragen Notizen eine Herkunft und verdienen Vertrauen durch Ergebnisse. Und ein Vault hat keine Ahnung, welcher Ihrer Agenten was geschrieben hat oder wie sie Aufgaben übergeben; hier ist das der ganze Punkt.

Obsidian ist, wo Sie Ihr Gehirn lesen. cookbook-brain ist das, was Ihre Agenten davon abhält, es zu ruinieren.

Verwendung mit Obsidian

Als Vault öffnen

Öffnen Sie das Gehirnverzeichnis (oder einen beliebigen Ordner, der es enthält) mit Obsidians „Ordner als Vault öffnen“. Keine Plugins nötig für die Grundlagen: Wikilinks werden aufgelöst, die Graph-Ansicht zeichnet, was Ihre Agenten wissen, und Rückverweise funktionieren einfach.

Warum die Links aufgelöst werden: Aliase

Dateinamen sind mit Datums-Slug versehen (2026-08-18--poll-interval-is-30s.md), aber Notiztexte verlinken per Titel ([[Poll interval is 30s]]). Die Brücke ist das aliases-Frontmatter-Feld: Jede Notiz trägt ihren eigenen Titel als Alias, und Obsidian löst Wikilinks über Aliase auf. Notizen, die mit cookbook-brain 0.5 und früher geschrieben wurden, fehlt das Feld; cookbook-brain doctor warnt davor, und

npx cookbook-brain doctor --fix-aliases

fügt aliases: [<title>] in jede aktive Notiz ein, die es vermisst. Dieser Stempel ist eine genehmigte Frontmatter-Ergänzung, dokumentiert in SCHEMA.md neben den Supersede- und Credit-Stempeln, und er berührt nie einen Textkörper.

Eigenschaftenansicht

Obsidian liest das Frontmatter als Eigenschaften: Öffnen Sie eine beliebige Notiz, und Sie sehen type, author, created, credits, last_credited und bei Aufgaben status, assigned_to, claimed_by, result. Das macht die Obsidian-Suche und das Eigenschaftenpanel zu einer kostenlosen Abfrageoberfläche über die Metadaten des Gehirns.

Das Gehirn in Ihrem Vault

Haben Sie bereits ein Vault? Legen Sie das Gehirn in einen Unterordner davon und weisen Sie die Werkzeuge darauf:

npx cookbook-brain init --dir ~/Vault/brain
claude mcp add brain -- npx cookbook-brain serve --dir ~/Vault/brain

Das Gedächtnis Ihrer Agenten lebt dann neben Ihren eigenen Notizen, Ihre Vault-Notizen können wie jede andere in Gehirnnotizen verlinken, und BRAIN_DIR funktioniert auf die gleiche Weise, wenn Sie eine Umgebungsvariable bevorzugen. Der Scanner liest nur .md-Dateien der obersten Ebene in diesem einen Ordner, sodass der Rest Ihres Vaults nie berührt wird.

Manuelle Bearbeitung

Ihre Dateien, bearbeiten Sie frei; die Append-Only-Disziplin bindet die Werkzeuge der Agenten, nicht Ihre Hände. Korrigieren Sie einen Tippfehler, formulieren Sie einen Text um, löschen Sie eine Notiz, die Sie nie wollten: Es ist Ihr Gehirn. Die Regel „niemals überschreiben“ existiert, damit keine KI stillschweigend die Geschichte umschreibt, nicht, um Sie auszusperren. Nach einer manuellen Massenbearbeitung sagt Ihnen cookbook-brain doctor, ob etwas einen Link, eine Supersede-Kette oder eine Aufgabe beschädigt hat.

Dataview-Snippets

Diese erfordern das Community-Plugin Dataview. Passen Sie FROM "brain" an, wenn Ihr Gehirnordner anders heißt.

Alle in Gutschriften stehenden Entscheidungen (der nächstgelegene Frontmatter-Proxy für die bewiesene Stufe; die genaue Stufenberechnung benötigt die Vertrauensformel, die web zeigt):

```dataview
TABLE credits, last_credited, author.agent AS agent
FROM "brain"
WHERE type = "decision" AND credits >= 1 AND !superseded_by
SORT credits DESC
```

Nie in Gutschriften stehende Fallstricke (aufgezeichnete Fallen, aber noch nie durch echte Arbeit bestätigt):

```dataview
TABLE created, author.agent AS agent
FROM "brain"
WHERE type = "gotcha" AND credits = 0 AND !superseded_by
SORT created ASC
```

Offene Aufgaben nach Bearbeiter:

```dataview
TABLE assigned_to, abandon_reason, created
FROM "brain"
WHERE type = "task" AND status = "open" AND !superseded_by
SORT assigned_to ASC
```

Die Startseite und die Stufenansicht

npx cookbook-brain index erzeugt INDEX.md im Gehirnstamm: Jede aktive Notiz als Wikilink, gruppiert nach Typ mit Konventionen zuerst, jede mit ihrer Stufe und Gutschriften. Es ergibt eine gute Vault-Startseite; es ist eine Ansicht, keine Notiz, also überschreibt die Neuerzeugung sie und der Scanner ignoriert sie. Und für das eine, was Obsidian nicht zeigt – die Live-Vertrauens- und Stufenberechnung – führen Sie npx cookbook-brain web aus: Ein schreibgeschützter Betrachter unter http://127.0.0.1:4321 mit Vertrauensbalken, Stufenabzeichen, der Aufgabentafel und den Traum- und Ernteberichten.

Wenn Ihr Team bereit ist

Ihr Gehirn und cookbook.team sprechen dieselbe Sprache: dieselben Notiztypen, dieselben Stufen, dieselbe Quellendisziplin, dieselben Aufgabenverben. Die Migration ist also eine Anweisung an einen Agenten, der mit beiden verbunden ist: Lesen Sie jede aktive Notiz in meinem Gehirn und merken Sie sie sich in meinem Teamarbeitsbereich, gleicher Typ, Titel, Text und Quelle. Die Zuordnung bleibt erhalten. Ihre Konventionen reiten auf dem Abruf jedes Teamkollegen, sobald sie landen.

Gutschriften werden bewusst nicht migriert: Teamvertrauen wird aus Teamergebnissen verdient, und importierte Behauptungen beginnen mit dem Vertrauen eines zitierten Agenten, bis die Arbeit des Teams sie beweist. Das Misstrauens-bis-bewiesen-Prinzip gilt auch für die Migration selbst.

Behalten Sie das Gehirn nach dem Upgrade. Viele Leute werden beides wollen: das Gehirn für den persönlichen Kontext, den Arbeitsbereich für den Teamkontext. Sie sind Ebenen, keine Rivalen.

Danksagungen und die ehrliche Karte

Mem0, Zep und Letta sind exzellente gehostete/Infrastruktur-Gedächtnisschichten mit Fähigkeiten, die dieses Werkzeug nicht hat (verwaltete Skalierung, temporale Graphen, Unternehmensfunktionen). QM liefert abgegrenztes, personenbezogenes Gedächtnis für Teams. cookbook-brain unterscheidet sich in drei Achsen: Ihr Gedächtnis sind Dateien, die Ihnen gehören, keine Zeilen in einem Dienst; jede Notiz ist zugeordnet und append-only; und Vertrauen wird aus Ergebnissen verdient, nicht zum Zeitpunkt des Schreibens behauptet. Wenn Sie eine verwaltete Gedächtnis-API möchten, verwenden Sie diese. Wenn Sie ein Gehirn möchten, das Sie lesen können, verwenden Sie dieses.

Warum wir dies gebaut haben

Bei cookbook.team bauen wir die Multiplayer-Version: einen gemeinsamen Arbeitsbereich, in dem Menschen und Agenten eines Teams an einem Board arbeiten, ein Gehirn teilen und jede Aufgabe eine Quittung ausstellt, die die verwendete Erinnerung gutschreibt. cookbook-brain ist diese Erinnerungsschicht, Einzelspieler, kostenlos, dein. Falls dein Team jemals die gemeinsame Version möchte, weißt du, wo die Küche ist.

MIT, Copyright Diego Prozzi.