Dokumentation durchsuchen

bmad-plus memory

Den Zustand des Projektgedächtnisses und des globalen Brains prüfen und das globale Brain in eine Markdown-Datei exportieren. Optionen, Lese- und Schreibzugriffe, Ausgabe, Exit-Codes, Fehler.

Auf dieser Seite
  1. Syntax
  2. Was gelesen und geschrieben wird
  3. Exit-Codes
  4. Die Ausgabe lesen
  5. Fehler und was zu tun ist
  6. Beispiele

BMAD+ hält zwei Arten von Gedächtnis in einfachen Markdown-Dateien. Das Projektgedächtnis liegt in .agents/memory/ in deinem Projekt (Entscheidungen, Erkenntnisse, Muster, der aktuelle Kontext und je Sitzung eine Übergabenotiz). Das globale Brain liegt in ~/.bmad-plus/brain und wird von all deinen Projekten geteilt. bmad-plus memory beantwortet „Ist mein Gedächtnis in Ordnung?“ mit einem schreibgeschützten Bericht und kann das globale Brain in eine portable Datei kopieren. Es ist für alle, die das Pack Memory (Agent Zecher) installiert haben und es prüfen oder sichern möchten.

Syntax

Im Terminal deines Projekts
npx bmad-plus memory [status] [-d <path>] [-l <code>]
npx bmad-plus memory export [-d <path>] [-l <code>]

Argumente und Optionen von memory
OptionArgumentStandardWirkung
[subcommand]status oder exportstatusstatus gibt den Zustandsbericht aus; export schreibt das globale Brain in eine Datei im Projektordner. Alles andere gibt einen Fehler aus.
-d, --directory <path>Pfadaktuelles VerzeichnisProjektordner: von hier wird .agents/memory/ gelesen und hierhin wird die Exportdatei geschrieben.
-l, --lang <code>en, fr, es, de, pt-br, ru, zh, he, ja, itkeinerAus Gründen der Einheitlichkeit akzeptiert. Der Bericht selbst erscheint immer auf Englisch.

Was gelesen und geschrieben wird

Dateizugriffe von memory
UnterbefehlLiestSchreibt
status.agents/memory/decisions.md, lessons.md, patterns.md, context.md, sessions/*.md, .brain-link; im globalen Brain identity.yaml, decisions.md, lessons.md, patterns.md, projects/*.yaml, projects-index.md.Nichts.
exportDas globale Brain: identity.yaml, decisions.md, lessons.md, patterns.md und jede projects/*.yaml.bmad-brain-export-<YYYY-MM-DD>.md im Projektordner (wird ersetzt, wenn es an dem Tag schon existiert).

Zwei Details sind wichtig. Erstens prüft der Bericht immer das globale Brain in ~/.bmad-plus/brain, auch wenn dein Projekt mit einem anderen Brain verknüpft ist (ein Ordner _brain/ in einem übergeordneten Verzeichnis, die Variable BMAD_PLUS_BRAIN); die Verknüpfung steht in der Zeile „Linked brain“. Zweitens berührt export nicht das Projektgedächtnis, nur das globale Brain. Ein „Eintrag“ in den Zählungen ist eine Zeile, die in der Markdown-Datei mit ### beginnt.

Exit-Codes

Exit-Codes von memory
CodeBedeutung
0Der Befehl lief bis zum Ende. Das gilt auch für einen unbekannten Unterbefehl und einen Export ohne globales Brain: Beide geben eine Fehlerzeile aus, setzen aber keinen Fehlercode. Verwende memory daher nicht als CI-Gate.

Die Ausgabe lesen

Der Gesundheitswert ist der Anteil bestandener Prüfungen an höchstens zehn. Für das Projektgedächtnis sind es fünf: decisions.md, lessons.md, patterns.md und context.md existieren, und sessions/ enthält mindestens eine .md-Übergabe. Für das globale Brain: identity.yaml, decisions.md, lessons.md, patterns.md und der Ordner projects/ existieren. Ein nicht installierter Teil wird aus dem Wert ausgelassen, statt als null zu zählen. Grün ab 80 %, gelb ab 50 %.

memory status (Werte beispielhaft)Simuliert
npx bmad-plus memory status
Project Memory (/home/ana/shop)
  decisions.md     ✓  3 entries  2026-10-12
  lessons.md       ✓  1 entries  2026-10-02
  patterns.md      ✓  0 entries  2026-09-30
  context.md       ✓  2026-10-17
  sessions/        ✓  2 handoff(s)
  Linked brain: /home/ana/.bmad-plus/brain
Global Brain (/home/ana/.bmad-plus/brain)
  identity.yaml    ✓
  decisions.md     ✓  0 entries
  lessons.md       ✓  0 entries
  patterns.md      ✓  0 entries
  projects/        ✓  1 project(s) indexed
  projects-index   ·
Health: 100% (10/10 checks)
Done!

Beispielhafter Ablauf, nicht bei einem echten Lauf aufgezeichnet. Quelle: tools/cli/commands/memory.js (Zweig status, Meldungsvorlagen); Zahlen und Pfade sind erfunden

memory export (Pfad beispielhaft)Simuliert
npx bmad-plus memory export
Brain exported to: /home/ana/shop/bmad-brain-export-2026-10-18.md
Done!

Beispielhafter Ablauf, nicht bei einem echten Lauf aufgezeichnet. Quelle: tools/cli/commands/memory.js (Zweig export, Meldungsvorlage); der Pfad ist erfunden

Hinweis Vor dem Weitergeben des Exports prüfen

Der Export kopiert deine globalen Entscheidungen, Erkenntnisse und Projektkarten wörtlich, dazu identity.yaml (dein Name und deine Sprache). Lies ihn, bevor du ihn weitergibst oder committest.

Fehler und was zu tun ist

Von memory ausgegebene Meldungen
MeldungUrsacheWas tun
Not installed. Run: npx bmad-plus install (select Memory pack)Im Projekt gibt es keinen Ordner .agents/memory/.Installiere das Pack Memory: npx bmad-plus install --packs memory.
Not initialized. Run: npx bmad-plus install (select Memory pack)Auf diesem Rechner gibt es keinen Ordner ~/.bmad-plus/brain.Installiere das Pack Memory in irgendeinem Projekt; es legt das globale Brain an, außer es findet ein anderes Brain zum Verknüpfen.
Global brain not found. Nothing to export.Der Export schaut nur in ~/.bmad-plus/brain.Führe die obige Installation aus oder nutze scan, um das Brain zu füllen.
Unknown subcommand: <name>Alles außer status oder export.Nutze status oder export. Für Abruf und Journal gibt es mem.
identity.yaml ✗ missingEin globales Brain ohne Identitätsdatei (ein „halbes Brain“).Führe die Installation des Packs Memory erneut aus; sie ergänzt fehlende Dateien und überschreibt vorhandene nie.

Beispiele

Den Zustand deines Gedächtnisses prüfen

Das Pack Memory ist installiert, und du willst wissen, was fehlt, bevor du dich darauf verlässt.

In deinem KI-Assistenten
Führe `bmad-plus memory status` in diesem Projekt aus und sag mir, welche Gedächtnisdateien fehlen oder leer sind.

Das solltest du erhalten Der Befehl gibt einen Block für das Projektgedächtnis und einen für das globale Brain aus. Jede Datei zeigt ein Häkchen oder Kreuz, ihre Zahl an ### -Einträgen und das Datum der letzten Änderung, sessions/ zeigt die Zahl der Übergaben, und die letzte Zeile nennt den Gesundheitswert mit der Zahl bestandener Prüfungen. Auf der Platte ändert sich nichts.

Das globale Brain sichern

Du installierst deinen Rechner neu und willst eine lesbare Kopie dessen, was das Brain enthält.

In deinem KI-Assistenten
Exportiere mein globales Brain mit `bmad-plus memory export` und sag mir, wo die Datei liegt.

Das solltest du erhalten Im Projektordner entsteht eine Datei bmad-brain-export-<date>.md. Sie beginnt mit # BMAD+ Brain Export und der Exportzeit, danach je globaler Datei (identity.yaml, decisions.md, lessons.md, patterns.md) ein Abschnitt im Codeblock, dann ein Abschnitt Projects mit einer YAML-Karte je indiziertem Projekt. Der Befehl gibt den vollständigen Pfad aus.