Memroam

Dein Gedächtnis sollte nicht an ein einziges Modell gebunden sein. Memroam gibt jedem KI-Agenten, den du verwendest – Claude Code, Codex, Cursor, ChatGPT und Freunde – einen gemeinsamen, portablen Speicher: Bringe einer Umgebung eine Konvention bei, wechsle mitten in der Aufgabe zu einer anderen, und sie setzt genau dort fort, wo du aufgehört hast. Keine Datenbank, keine Embeddings: einfache Markdown-Dateien, die dir gehören, über MCP mit einem Befehl mit jedem Agenten verbunden. Dein Gedächtnis wandert mit dir.

Memroam speichert Fakten als gewöhnliche Markdown-Dateien. Jedes Projekt erhält einen isolierten Speicherbereich, während shared/ Fakten enthält, die projektübergreifend gelten. Die Dateien bleiben auf deinem Rechner (oder in deinem eigenen GitHub-Repository mit dem gehosteten Tarif) und bleiben vollständig nutzbar, wenn du Modelle oder Agent-Umgebungen wechselst – das ist der Punkt.

So funktioniert es

Der MCP-Server bietet einem Agenten sechs Dateioperationen – view, create, str_replace, insert, delete und rename – sowie search, eine vaultweite Stichwortsuche über Frontmatter und Inhalte.

Der Agent schreibt kleine Speicherdateien; der MEMORY.md-Index jedes Bereichs wird vom Server nach jeder Änderung aus dem Frontmatter der Dateien generiert (eine direkte Bearbeitung wird verweigert). Jede neue Erinnerung erhält eine unveränderliche UUIDv7-id: bei der Erstellung, und create weigert sich, eine vorhandene Datei zu ersetzen, es sei denn, es wird zum Überschreiben aufgefordert. Es gibt keine Datenbank oder ein Embedding-Modell. Die Markdown-Dateien sind die Quelle der Wahrheit, sodass du sie selbst lesen, bearbeiten, grep oder versionieren kannst.

memory/
  MEMORY.md          # index of project spaces
  shared/
    MEMORY.md        # cross-project facts
    *.md
  <project>/
    MEMORY.md        # project index
    *.md

Eine Projektverbindung liest und schreibt standardmäßig ihren eigenen Bereich, aber der gesamte Tresor bleibt sichtbar – andere Bereiche sind über Pfade adressierbar, und die Root-Liste zeigt jeden Bereich. Der Geltungsbereich ist eine Routing-Standardeinstellung, keine Mauer. Eine nicht eingeschränkte Verbindung startet im Tresor-Root für projektübergreifende Wartung.

Related MCP server: auxly-memory-cli

Voraussetzungen

• Node.js 18 oder neuer

• Ein MCP-Client, der stdio (globale Installation) oder Streamable HTTP (pro-Repo-Installation) unterstützt

Memroam hat keine Laufzeitabhängigkeiten.

Global installieren (empfohlen)

Verbinde jede Umgebung auf deinem Rechner einmal:

npx -y memroam install --global

Für jede erkannte Umgebung schreibt dies eine benutzerbezogene stdio-MCP-Registrierung und das Speicherritual in ihre globale Regeln-Datei – Claude Code (~/.claude.json + ~/.claude/CLAUDE.md), Cursor (~/.cursor/mcp.json), Codex (~/.codex/config.toml + ~/.codex/AGENTS.md), DeepSeek Harness (~/.dsh/AGENTS.md + einen stdio-Mount in jedem Profil cordis.patch.yml), OpenCode (~/.config/opencode/opencode.json + AGENTS.md), Gemini CLI (~/.gemini/settings.json + ~/.gemini/GEMINI.md) und Antigravity (~/.gemini/config/mcp_config.json + eine immer aktive Regel in ~/.gemini/config/rules/). Danach erhält jede Sitzung in jedem Repository den Tresor ohne Einrichtung pro Repo: Die Umgebung startet memroam stdio im Verzeichnis der Sitzung, und der Server leitet den Projektbereich automatisch aus diesem Verzeichnis ab (das nächste .git, sonst das flachste Paketmanifest; kein Marker bedeutet den Bereich default). Die Regel ist für jede Umgebung dieselbe: Eine MEMORY_SPACE-Umgebungsvariable am Server-Eintrag legt den Bereich explizit fest, sonst benennen die MCP-Workspace-Roots des Clients ihn (für Umgebungen, die MCP-Server außerhalb des Sitzungsverzeichnisses starten), sonst entscheidet das Verzeichnis. Erkannte Bereiche werden in ~/.memory-vault-connections.json aufgezeichnet, damit sie stabil bleiben.

npx -y memroam install --global --dry-run        # preview changes
npx -y memroam install --global --store <dir>    # choose the store (default ~/.memroam)
npx -y memroam uninstall --global                # undo exactly what install wrote

Starte deine Sitzungen nach der Installation neu. Die Installation pro Repo install (unten) bleibt für teamweit geteilte, eingecheckte Konfigurationen oder einen benutzerdefinierten Bereichsnamen. Vorhandene ~/.memory-vault-Speicher aus früheren Versionen werden erkannt und behalten – nichts bewegt sich ohne dich.

In ein Repository installieren

Führe dies aus dem Repository aus, das du verbinden möchtest:

npx -y memroam install

Dieser Befehl:

1. Startet den lokalen Server, falls er nicht bereits läuft.

2. Fragt, welche Umgebungen verbunden werden sollen, wobei die erkannten vorausgewählt sind (nur interaktive Terminals – überall sonst wird der erkannte Satz unverändert verwendet).

3. Schreibt die MCP-Konfiguration jeder gewählten Umgebung und die gemeinsamen Regeln-Dateien.

Standardmäßig speichert install den Speicher in ~/.memroam (ein vorhandenes ~/.memory-vault wird berücksichtigt) und leitet den Projektnamen aus dem aktuellen Verzeichnis ab. connect ist ein Alias für install.

npx -y memroam install --dry-run                # preview changes
npx -y memroam install --project my-app         # choose the project name
npx -y memroam install --harness claude,codex   # skip the prompt, pick explicitly
npx -y memroam install --yes                    # skip the prompt, accept detected

Starte deine Agent-Sitzung nach der Installation neu und genehmige den vault-MCP-Server, wenn du dazu aufgefordert wirst.

Aus einem Repository deinstallieren

npx -y memroam uninstall

Entfernt alles, was install in das Repository geschrieben hat – die MCP-Einträge, die Regeln-Abschnitte, den dsh-Patch – und löscht eine Datei nur, wenn sie nichts anderes enthielt. Deine Erinnerungen werden nie berührt, und der Server läuft für andere Projekte weiter. disconnect ist ein Alias für uninstall.

Die Verbindung überprüfen

npx -y memroam status

Zeigt an, ob der Server läuft und welchen Speicher er bedient, wie das aktuelle Repository pro Umgebung verbunden ist und jedes Repository, das von install aufgezeichnet wurde (gespeichert in ~/.memory-vault-connections.json). Wenn der Server läuft und das Repo verbunden ist, aber deine Agent-Sitzung keine Tresor-Werkzeuge hat, ist die verbleibende Ursache die Sitzungsanbindung – status gibt aus, wie man sie behebt.

Native Erinnerungen importieren, auf erinnerungslose Umgebungen projizieren

npx -y memroam import     # Claude Code auto-memory + Codex sqlite → candidates/
npx -y memroam project    # regenerate the read-only shared/ block in dsh's AGENTS.md

import kopiert den nativen Speicher jeder Umgebung in das candidates/-Verzeichnis des passenden Bereichs – durchsuchbar und mit [candidate] gekennzeichnet, vom Index ausgeschlossen, nie automatisch in den kanonischen Speicher geschrieben. Der Codex-Reader ist schreibgeschützt und lehnt unbekannte Datenbankschema-Versionen ab. Beide Befehle geben einen Fähigkeitsbericht darüber aus, was sie verschieben können und was nicht, und akzeptieren --dry-run / --json.

Unterstützte Umgebungen

Für DSH starte eine Sitzung mit dem generierten Patch:

dsh --patch ./dsh-cordis.patch.yml --profile headless "your task"

Gehosteter Tarif

Der gehostete Tarif ist derselbe Server, der für dich betrieben wird: ein entfernter MCP-Endpunkt, der mit OAuth 2.1 gesichert ist und deine Erinnerungen als Commits in einem privaten GitHub-Repository speichert, das dir gehört. Verbinde ihn mit Claude (claude.ai benutzerdefinierter Connector), ChatGPT (benutzerdefinierter Connector über den OpenAI-Such-/Abrufvertrag), Codex oder einem beliebigen Remote-MCP-Client:

https://memroam.com/mcp

Jede Erinnerung ist eine Markdown-Datei in deinem Repo – klone sie, grep sie, nimm sie überallhin mit. Der Verlust des Zugriffs auf den gehosteten Tarif bedeutet nie den Verlust deiner Erinnerungen.

Server direkt ausführen

MEMORY_DIR=~/.memroam npx memroam

Der Server lauscht standardmäßig auf 127.0.0.1:8787.

Aus einem geklonten Repository führt npm start denselben Server aus.

MCP-Endpunkte

POST /mcp/<project>  project memory plus shared memory
POST /mcp            whole-vault access

Zum Beispiel ist eine manuelle Claude-Code-Verbindung:

claude mcp add --transport http --scope project vault http://localhost:8787/mcp/my-project

Speicherformat

Speichere eine dauerhafte Tatsache pro Markdown-Datei:

---
name: preferred-language
description: The project's preferred implementation language
---

Use TypeScript for new application code.

Der Server stempelt eine id: und generiert die MEMORY.md-Indexzeile des Bereichs automatisch aus der description: neu. Er weist Agenten an, vor dem Erstellen einer Erinnerung nach einer vorhandenen zu suchen, Fakten zu aktualisieren statt zu duplizieren und Erinnerungen zu entfernen, die falsch werden.

Aktueller Umfang

Die aktuelle Version ist ein Markdown-Speicher (lokaler Ordner oder gehostet mit GitHub-Unterstützung), eine MCP-Schnittstelle mit Stichwortsuche, OAuth 2.1 auf dem gehosteten Tarif, ein umgebungsübergreifender Einrichtungsbefehl und einmalige Import-/Projektionsadapter. Es gibt keine automatische Extraktion, semantische Suche oder automatisierte Deduplizierung.

Paket

• npm: memroam (früher memory-vault)

• MCP-Registry: com.memroam/memroam

• Lizenz: MIT