claude-lens

MCP-Server, der Claude Code ein durchsuchbares Gedächtnis über alle vergangenen Sitzungen verleiht.

Indiziert jede Sitzungs-JSONL-Datei von Claude Code in einer SQLite-Datenbank mit FTS5-Volltextsuche. Claude erhält Tools, um Unterhaltungen zu durchsuchen, vergangene Tool-Aufrufe zu finden, nach Projekt oder Datum zu filtern und Fehler nachzuschlagen, die es bereits gelöst hat.

So funktioniert es

Claude Code speichert Sitzungen als JSONL-Dateien in ~/.claude/projects/. claude-lens parst diese beim Start, erstellt einen FTS5-Suchindex und stellt über MCP 9 Tools bereit. Claudes Agenten-Loop entscheidet, wann die eigene Historie durchsucht wird — kein manueller Aufruf nötig.

Das ist aktives Erinnern, kein passives RAG. Claude entscheidet, wonach gesucht wird, liest die Ergebnisse und kann mit Folgeabfragen tiefer gehen. Dasselbe Muster wie bei einem Menschen, der eine Suchmaschine benutzt — mehrere gezielte Abfragen schlagen einen einzigen blinden Abruf.

Related MCP server: conversation-search

Tools

Installation

git clone https://github.com/jasonpaulmichaels/claude-lens.git
cd claude-lens
bash scripts/install.sh

Oder manuell:

# Sync repo to runtime install location
rsync -a --exclude=node_modules --exclude=.git --exclude=test \
  ./ ~/.claude/mods/claude-lens/
cd ~/.claude/mods/claude-lens && npm install --omit=dev

# Register MCP server (user scope so it's available everywhere)
claude mcp add -s user claude-lens -- node ~/.claude/mods/claude-lens/src/index.js

install.sh erledigt das für dich. Das Quell-Repository bleibt von der Laufzeitinstallation getrennt — bearbeite den Quellcode und führe install.sh erneut aus, um die Änderungen bereitzustellen.

Starte Claude Code nach der Installation neu. Beim ersten Start werden alle Sitzungen indiziert (das dauert ein paar Minuten). Folgestarts sind inkrementell (<5 Sekunden).

Nutzung

Nutze Claude Code einfach ganz normal. Wenn Kontext aus vergangenen Sitzungen hilfreich wäre, durchsucht Claude automatisch den Verlauf. Du kannst auch direkt fragen:

• "Woran habe ich letzte Woche gearbeitet?"

• "Wie habe ich den Auth-Bug in betterclaw behoben?"

• "Finde die Sitzung, in der ich den cloudflare tunnel eingerichtet habe."

• "Welchen Befehl habe ich ausgeführt, um das Kernel-Modul neu zu bauen?"

• "Zeig mir Fehler, auf die ich bei der Arbeit an listforge gestoßen bin."

Anforderungen

• Node.js 20+

• Claude Code mit MCP-Unterstützung

Daten

• Indizierte Sitzungen aus: ~/.claude/projects/

• Datenbank gespeichert unter: ~/.claude-lens/claude-lens.db

• Subagent-Sitzungen werden übersprungen

• Tool-Ausgaben werden auf 500 Zeichen gekürzt, um die Datenbank handhabbar zu halten

• Inkrementelle Indizierung durch Nachverfolgung der Datei-mtime

Lizenz

MIT