Mooncite

Mooncite bietet lokalen Coding-Agenten begrenzten, zitiergestützten Abruf aus autorisierter Pi-, OMP-, Claude-Code-, Codex- und ChatGPT-Konversationshistorie. Der Abruf liefert deterministische Evidenz-Locators; eine verified-Inspektion vergleicht sie mit den aktuellen physischen Quellbytes, bevor ein Quellfenster zurückgegeben wird. Mooncite ruft früheren Kontext ab – es entscheidet nicht, was dieser Kontext bedeutet oder ob er weiterhin maßgeblich ist.

Install

Erfordert Linux mit procfs, Node.js 24 oder neuer und den npm-Befehl. Das Abrufen des getaggten Pakets erfordert außerdem Zugriff auf GitHub. Mooncite schlägt fehl, wenn es autorisierte Quellwurzeln nicht über Linux-Dateideskriptoren verankern kann.

npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.5 install

Optional den installierten Launcher separat verifizieren:

"$HOME/.local/bin/mooncite" status

Tagged v4.0.5 ist die aktuelle stabile Version und wird von GitHub statt aus der npm-Registry verteilt.

Um die aktuelle Vorabversion auszuprobieren, ohne den stabilen Tag zu ersetzen:

npx --yes github:WhenMoon-afk/claude-memory-mcp#v4.0.6-preview.1001.0 install

Eine frische Installation platziert ein stabiles Paket unter $XDG_DATA_HOME/mooncite (Standard ~/.local/share/mooncite), erstellt den Evidenzindex unter $XDG_STATE_HOME/mooncite (Standard ~/.local/state/mooncite) und erstellt einen exakten Launcher-Link unter ~/.local/bin/mooncite. Es konfiguriert jeden unterstützten Client, den es verifizieren kann:

• Pi: verpackte dünne Erweiterung

• Oh My Pi (OMP): verknüpftes Paket mit einer verpackten .mcp.json

• Codex: lokale stdio-MCP-Registrierung

• Claude Code: lokale stdio-MCP-Registrierung

Das Installationsergebnis meldet jede Registrierung. Verwenden Sie einen Client nur, wenn sein Wert exact ist; nicht verfügbare Clients werden gemeldet und unangetastet gelassen. Eine widersprüchliche mooncite-Registrierung, ein nicht zusammenhängender Launcher-Befehl oder ein anderes Paket am stabilen Installationspfad wird abgelehnt, nicht überschrieben.

Nach jeder Installation oder Neuinstallation müssen Sie jeden konfigurierten Client vollständig neu starten oder neu laden, bevor Sie Mooncite verwenden. Ein bereits laufender Client oder MCP-Kindprozess ist nicht garantiert hot-reload-fähig und kann weiterhin alten Code oder alten Zustand bedienen.

Wenn Ihre Shell mooncite: command not found meldet, hat der Installer Ihre Shell-Startdateien nicht bearbeitet. Verwenden Sie den oben gezeigten exakten Pfad oder fügen Sie das Launcher-Verzeichnis zu PATH hinzu:

export PATH="$HOME/.local/bin:$PATH"
mooncite status

Pi und OMP verwenden ihre Standard-Sitzungswurzeln. Optionale automatische Wurzeln sind ~/.claude/projects, ~/.config/claude-sol/projects, ~/.codex/sessions (oder $CODEX_HOME/sessions) und ~/incoming/chatgpt-share-archive. Eine explizite source add-Wurzel überschreibt die automatische Erkennung für diesen Ursprung. Starten Sie einen Prozess mit MOONCITE_AUTO_SOURCES=0, um alle optionalen automatischen Wurzeln zu deaktivieren. ChatGPT ist ein Quell-Ursprung, keine fünfte Client-Registrierung.

Related MCP server: Claude Memory MCP

First recall

Recall ist ein MCP-Tool, das innerhalb eines registrierten Clients verwendet wird, kein mooncite recall-Shell-Befehl. Nach dem Neustart eines Clients, dessen Registrierung exact ist, fügen Sie diesen Prompt ein:

Rufen Sie mooncite_recall mit einer markanten Phrase aus einem früheren Gespräch auf. Lesen Sie dessen outcome, conclusive, meaning, Kandidaten-match, Warnungen und next. Wenn ein Kandidat zurückgegeben wird, übergeben Sie die evidence_id des besten Kandidaten an mooncite_inspect. Behandeln Sie verified als physische Provenienz, nicht als Wahrheit oder aktuelle Autorität. Wenn der Abruf inconclusive oder unavailable ist, folgen Sie seiner nächsten Aktion, anstatt zu behaupten, die Evidenz sei nicht vorhanden.

Tools

Standardmäßig stellt Mooncite genau drei Evidenz-MCP-Tools bereit:

• mooncite_recall — begrenzte lexikalische Suche mit expliziten matches-, weak_leads-, no_match-, inconclusive-, invalid_scope- und unavailable-Ergebnissen

• mooncite_inspect — eine Evidenz-ID oder URI gegen aktuelle physische Bytes verifizieren und ein begrenztes Quellfenster zurückgeben

• mooncite_status — Bereitschaft, Degradation oder Nichtverfügbarkeit melden, Quellzahlen nach Ursprung, Aktualisierungszeit, gruppierte Fehler und Registrierungsstatus ohne Transkripttext

Recall erklärt exakte/Phrasen-/Begriffsübereinstimmung, übereinstimmende und fehlende Begriffe, Ausschnittkürzung, Duplikat-Kollaps, Unterdrückung rekursiver Ausgaben und eine konkrete nächste Aktion. Beginnen Sie ohne Bereich. Eingrenzen nur mit dem exakten project oder der quellenqualifizierten sessionId, die von einem Kandidaten kopiert wurde. Recall durchsucht zuerst die aktuelle Projektion und führt nur bei einem Fehlschlag eine begrenzte inkrementelle Aktualisierung durch; mooncite rebuild bleibt eine explizite vollständige Operation.

Verwenden Sie zuerst Recall und prüfen Sie dann den zurückgegebenen mooncite:<origin>:…- oder mooncite://<origin>/…-Locator, bevor Sie sich auf die Evidenz verlassen. Eine verified-Inspektion bedeutet, dass die zitierten physischen Bytes und die Identität mit dem aktiven Index übereinstimmen; sie stellt nicht fest, dass die zitierte Behauptung korrekt oder weiterhin maßgeblich ist. Ursprünge sind pi, omp, claude-code, codex und chatgpt.

Diese Vorabversion verfügt außerdem über einen separaten, standardmäßig deaktivierten Lernspeicher-Modus. mooncite memory enable schreibt eine strenge, eigentümerprivate Opt-in-Erklärung; nach jedem Neustart eines Clients fügt es bedingt mooncite_memory_recall, mooncite_memory_inspect, mooncite_memory_write und mooncite_memory_delete hinzu. Diese Tools speichern explizite, zitiergestützte abgeleitete Interpretationen in $XDG_STATE_HOME/mooncite/learned-memory.sqlite. Sie fügen niemals gelernten Text zu Quell-Evidenz oder zum Wegwerf-Evidenzindex hinzu. Verwenden Sie mooncite memory disable, um die Tools auszublenden, während der gelernte Zustand erhalten bleibt, und mooncite memory status, um die Bereitschaft zu prüfen.

Common operations

mooncite status
mooncite rebuild
mooncite source list

source add zeichnet eine explizite lokale Überschreibung auf, ohne Verlauf zu kopieren; source remove entfernt nur diese Überschreibung, sodass eine verfügbare automatische Wurzel wieder aktiv werden kann.

disable entfernt nur Client-Registrierungen, die als Eigentum der Installation aufgezeichnet sind. uninstall entfernt außerdem das erkannte stabile Paket und den exakten Launcher-Link. Beide bewahren Quellverlauf, Quellautorisierungen, den Evidenzindex, die Lernspeicher-Konfiguration und jede gelernte Datenbank. Starten Sie nach beiden Befehlen betroffene Clients vollständig neu oder laden Sie sie neu, damit zuvor geladene Tools nicht mehr ausgeführt werden.

purge --yes löscht separat nur erkannten, Mooncite-eigenen abgeleiteten Zustand, einschließlich der Evidenz- und Lernspeicher-SQLite-Dateien, und lehnt unbekannte Einträge ab. Es lässt Quellverlauf und beide Konfigurationsdateien intakt. Mooncite hat keinen In-Place-Update-Mechanismus über Versionen hinweg. Siehe operations für Quellbefehle, Lernspeicher-Aufbewahrung, konservative Entfernungsreihenfolge, Fehlerbehandlung und Versionsänderungen.

ChatGPT desktop conversations

Die ChatGPT-Desktop-Apps verwenden denselben kontoabhängigen Konversationsdienst wie ChatGPT im Web; Mooncite durchsucht keine App-Caches, Browser-Cookies oder Anmeldedaten. Fordern Sie den unterstützten Datenexport in ChatGPT unter Einstellungen → Datenkontrollen → Export an, extrahieren Sie ihn nach ~/incoming/chatgpt-share-archive (oder registrieren Sie das extrahierte Verzeichnis mit source add chatgpt) und führen Sie dann mooncite rebuild aus. Mooncite scannt conversation.json-, conversations.json- und nummerierte conversations-N.json-Dateien; jede kann ein Konversationsobjekt oder ein Array auf oberster Ebene enthalten.

Privacy boundary

Mooncite ist lokal und schreibgeschützt in Bezug auf jede Quelldatei. Die automatische Erkennung ist auf die genannten Standardwurzeln beschränkt und kann für einen Prozess mit MOONCITE_AUTO_SOURCES=0 deaktiviert werden. Recall gibt begrenzte Auszüge zurück; nur eine verified-Inspektion enthält ein aktuell-quellverifiziertes Fenster. Text, der über ein MCP-Tool gesendet wird, wird zu Modellkontext und unterliegt dann der Datenverarbeitung des jeweiligen Modellanbieters. Mooncite lädt keinen Verlauf hoch, fordert keine ChatGPT-Exporte an und ruft kein SSH auf; Remote-Verlauf muss zuerst in eine lokale Wurzel kopiert oder eingehängt werden.

Siehe architecture, protocol, operations und security.

Repository: https://github.com/WhenMoon-afk/claude-memory-mcp