🌐 Dies ist eine automatisierte Übersetzung. Korrekturen aus der Community sind willkommen!

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Persistentes Speicherkomprimierungssystem, entwickelt für Claude Code.

Schnellstart • Wie es funktioniert • Suchwerkzeuge • Dokumentation • Konfiguration • Fehlerbehebung • Lizenz

Claude-Mem bewahrt nahtlos Kontext über Sitzungen hinweg, indem es automatisch Beobachtungen zur Tool-Nutzung erfasst, semantische Zusammenfassungen generiert und diese für zukünftige Sitzungen verfügbar macht. Dies ermöglicht es Claude, die Kontinuität des Wissens über Projekte aufrechtzuerhalten, auch nachdem Sitzungen beendet wurden oder die Verbindung wiederhergestellt wird.

---

Schnellstart

Installation mit einem einzigen Befehl:

npx claude-mem install

Oder Installation für OpenCode:

npx claude-mem install --ide opencode

Oder Installation für Antigravity CLI (Einrichtungsanleitung):

npx claude-mem install --ide antigravity

Oder Installation über den Plugin-Marketplace innerhalb von Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch in neuen Sitzungen angezeigt.

Hinweis: Claude-Mem ist auch auf npm veröffentlicht, aber npm install -g claude-mem installiert nur das SDK/die Bibliothek — es registriert weder die Plugin-Hooks noch richtet es den Worker-Dienst ein. Installieren Sie immer über npx claude-mem install oder die oben genannten /plugin-Befehle.

🦞 OpenClaw Gateway

Installieren Sie claude-mem als persistentes Speicher-Plugin auf OpenClaw-Gateways mit einem einzigen Befehl:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Der Installer übernimmt Abhängigkeiten, Plugin-Einrichtung, KI-Anbieter-Konfiguration, Worker-Start und optionale Echtzeit-Beobachtungs-Feeds zu Telegram, Discord, Slack und mehr. Details finden Sie im OpenClaw-Integrationsleitfaden.

Hauptmerkmale:

• 🧠 Persistenter Speicher - Kontext bleibt über Sitzungen hinweg erhalten
• 📊 Progressive Offenlegung - Schichtweiser Speicherabruf mit Sichtbarkeit der Token-Kosten
• 🔍 Skill-basierte Suche - Durchsuchen Sie Ihre Projekthistorie mit dem mem-search Skill
• 🖥️ Web-Viewer-UI - Echtzeit-Speicherstream unter der beim Start ausgegebenen Worker-URL
• 💻 Claude Desktop Skill - Durchsuchen Sie den Speicher aus Claude Desktop-Konversationen
• 🔒 Datenschutzkontrolle - Verwenden Sie <private>-Tags, um sensible Inhalte von der Speicherung auszuschließen
• ⚙️ Kontextkonfiguration - Feinkörnige Kontrolle darüber, welcher Kontext eingefügt wird
• 🤖 Automatischer Betrieb - Keine manuelle Intervention erforderlich
• 🔗 Zitate - Referenzieren Sie vergangene Beobachtungen mit IDs über die Worker-API oder sehen Sie alle im Web-Viewer

---

Dokumentation

📚 Vollständige Dokumentation anzeigen - Auf der offiziellen Website durchsuchen

Erste Schritte

• Installationsanleitung - Schnellstart & erweiterte Installation
• Nutzungsanleitung - Wie Claude-Mem automatisch funktioniert
• Suchwerkzeuge - Durchsuchen Sie Ihre Projekthistorie mit natürlicher Sprache

Best Practices

• Context Engineering - Prinzipien der Kontextoptimierung für KI-Agenten
• Progressive Disclosure - Philosophie hinter Claude-Mems Kontext-Priming-Strategie

Architektur

• Übersicht - Systemkomponenten & Datenfluss
• Architekturentwicklung - Die Reise von v3 zu v5
• Hooks-Architektur - Wie Claude-Mem Lifecycle-Hooks verwendet
• Hooks-Referenz - 7 Hook-Skripte erklärt
• Worker Service - HTTP API & Bun-Verwaltung
• Datenbank - SQLite-Schema & FTS5-Suche
• Such-Architektur - Hybride Suche mit Chroma-Vektordatenbank

Konfiguration & Entwicklung

• Konfiguration - Umgebungsvariablen & Einstellungen
• Entwicklung - Erstellen, Testen, Beitragen
• Fehlerbehebung - Häufige Probleme & Lösungen

---

Wie es funktioniert

Kernkomponenten:

1. 5 Lifecycle-Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 Hook-Skripte)
2. Smart Install - Gecachter Abhängigkeitsprüfer (Pre-Hook-Skript, kein Lifecycle-Hook)
3. Worker Service - Lokale HTTP-API mit Web-Viewer-UI und Such-Endpunkten, verwaltet von Bun
4. SQLite-Datenbank - Speichert Sitzungen, Beobachtungen, Zusammenfassungen
5. mem-search Skill - Natürlichsprachliche Abfragen mit progressiver Offenlegung
6. Chroma-Vektordatenbank - Hybride semantische + Stichwortsuche für intelligenten Kontextabruf

Siehe Architekturübersicht für Details.

---

MCP-Suchwerkzeuge

Claude-Mem bietet intelligente Speichersuche durch 4 MCP-Tools nach einem token-effizienten 3-Schichten-Workflow-Muster:

Der 3-Schichten-Workflow:

1. search - Kompakten Index mit IDs abrufen (~50-100 Token/Ergebnis)
2. timeline - Chronologischen Kontext um interessante Ergebnisse herum abrufen
3. get_observations - Vollständige Details NUR für gefilterte IDs abrufen (~500-1.000 Token/Ergebnis)

Funktionsweise:

• Claude nutzt MCP-Tools, um Ihren Speicher zu durchsuchen
• Beginnen Sie mit search, um einen Index der Ergebnisse zu erhalten
• Verwenden Sie timeline, um zu sehen, was um bestimmte Beobachtungen herum geschah
• Verwenden Sie get_observations, um vollständige Details für relevante IDs abzurufen
• ~10-fache Token-Ersparnis durch Filtern vor dem Abrufen der Details

Verfügbare MCP-Tools:

1. search - Speicherindex mit Volltextabfragen durchsuchen, gefiltert nach Typ/Datum/Projekt
2. timeline - Chronologischen Kontext um eine bestimmte Beobachtung oder Abfrage herum abrufen
3. get_observations - Vollständige Beobachtungsdetails anhand von IDs abrufen (immer mehrere IDs gebündelt abrufen)

Beispielverwendung:

// Schritt 1: Nach Index suchen
search(query="authentication bug", type="bugfix", limit=10)

// Schritt 2: Index überprüfen, relevante IDs identifizieren (z. B. #123, #456)

// Schritt 3: Vollständige Details abrufen
get_observations(ids=[123, 456])

Siehe Suchwerkzeuge-Anleitung für detaillierte Beispiele.

---

Systemanforderungen

• Node.js: 20.0.0 oder höher
• Claude Code: Neueste Version mit Plugin-Unterstützung
• Bun: JavaScript-Laufzeitumgebung und Prozessmanager (wird automatisch installiert, falls fehlend)
• uv: Python-Paketmanager für Vektorsuche (wird automatisch installiert, falls fehlend)
• SQLite 3: Für persistente Speicherung (enthalten)

---

Hinweise zur Einrichtung unter Windows

Wenn folgender Fehler angezeigt wird:

npm : The term 'npm' is not recognized as the name of a cmdlet

Stellen Sie sicher, dass Node.js und npm installiert und zu Ihrem PATH hinzugefügt wurden. Laden Sie den neuesten Node.js-Installer von https://nodejs.org herunter und starten Sie Ihr Terminal nach der Installation neu.

---

Konfiguration

Einstellungen werden in ~/.claude-mem/settings.json verwaltet (wird beim ersten Start automatisch mit Standardwerten erstellt). Konfigurieren Sie KI-Modell, Worker-Port, Datenverzeichnis, Log-Level und Kontext-Injektionseinstellungen.

Siehe die Konfigurationsanleitung für alle verfügbaren Einstellungen und Beispiele.

Modus- & Sprachkonfiguration

Claude-Mem unterstützt mehrere Workflow-Modi und Sprachen über die Einstellung CLAUDE_MEM_MODE.

Diese Option steuert sowohl:

• Das Workflow-Verhalten (z. B. code, chill, investigation)
• Die Sprache, die in generierten Beobachtungen verwendet wird

Konfiguration

Bearbeiten Sie Ihre Einstellungsdatei unter ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Modi sind in plugin/modes/ definiert. Um alle lokal verfügbaren Modi anzuzeigen:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Verfügbare Modi

Modus	Beschreibung
code	Standardmodus (Englisch)
code--zh	Modus für vereinfachtes Chinesisch
code--ja	Modus für Japanisch

Sprachspezifische Modi folgen dem Muster code--[lang], wobei [lang] der ISO-639-1-Sprachcode ist (z. B. zh für Chinesisch, ja für Japanisch, es für Spanisch).

Hinweis: code--zh (vereinfachtes Chinesisch) ist bereits integriert — es ist keine zusätzliche Installation oder Plugin-Aktualisierung erforderlich.

Nach der Änderung des Modus

Starten Sie Claude Code neu, um die neue Moduskonfiguration anzuwenden.

Entwicklung

Siehe die Entwicklungsanleitung für Build-Anweisungen, Tests und Beitrags-Workflow.

---

Fehlerbehebung

Wenn Sie Probleme haben, beschreiben Sie das Problem Claude, und der troubleshoot Skill wird automatisch diagnostizieren und Lösungen bereitstellen.

Siehe die Fehlerbehebungsanleitung für häufige Probleme und Lösungen.

---

Fehlerberichte

Erstellen Sie umfassende Fehlerberichte mit dem automatisierten Generator:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Mitwirken

Beiträge sind willkommen! Bitte:

1. Forken Sie das Repository
2. Erstellen Sie einen Feature-Branch
3. Nehmen Sie Ihre Änderungen mit Tests vor
4. Aktualisieren Sie die Dokumentation
5. Reichen Sie einen Pull Request ein

Siehe Entwicklungsanleitung für den Beitrags-Workflow.

---

Lizenz

Claude-Mem ist unter der Apache License 2.0 lizenziert.

Wir haben uns für Apache-2.0 entschieden, weil dauerhafter agentenbasierter Speicher leicht in Entwicklertools, lokale Agenten, MCP-Server, Unternehmenssysteme, Robotik-Stacks und produktive Agenten-Harnesses eingebettet werden können sollte.

Siehe die Datei LICENSE für vollständige Details. Siehe docs/license.md und docs/ip-boundary.md für den Lizenzumfang und die Grenze zwischen offen und kommerziell.

---

Support

• Dokumentation: docs/
• Issues: GitHub Issues
• Repository: github.com/thedotmack/claude-mem
• Offizieller X-Account: @Claude_Memory
• Offizieller Discord: Discord beitreten
• Autor: Alex Newman (@thedotmack)

---

Erstellt mit Claude Agent SDK | Funktioniert mit Claude Code | Gemacht mit TypeScript

---

Was ist mit CMEM?

CMEM ist ein Token, der von einem Drittanbieter erstellt, aber offiziell vom Schöpfer von Claude-Mem (Alex Newman, @thedotmack) unterstützt wird. Der Token dient als Community-Katalysator für Wachstum und als Vehikel, um CMEM zu den Entwicklern und Wissensarbeitern zu bringen, die ihn am dringendsten benötigen.

Offizielle BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3