claude-lens

Servidor MCP que le da a Claude Code una memoria consultable de todas las sesiones pasadas.

Indexa cada archivo JSONL de sesión de Claude Code en una base de datos SQLite con búsqueda de texto completo FTS5. Claude obtiene herramientas para buscar conversaciones, encontrar llamadas a herramientas anteriores, filtrar por proyecto o fecha y consultar errores que ya ha resuelto antes.

Cómo funciona

Claude Code almacena las sesiones como archivos JSONL en ~/.claude/projects/. claude-lens los analiza al iniciarse, crea un índice de búsqueda FTS5 y expone 9 herramientas a través de MCP. El bucle del agente de Claude decide cuándo buscar en su propio historial — no se necesita ninguna invocación manual.

Esto es recuerdo activo, no RAG pasivo. Claude decide qué buscar, lee los resultados y puede profundizar con consultas de seguimiento. El mismo patrón que un humano al usar un buscador — varias consultas específicas superan a una sola recuperación a ciegas.

Related MCP server: conversation-search

Herramientas

Instalación

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

O manualmente:

# 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 hace esto por ti. El repositorio fuente se mantiene separado de la instalación en tiempo de ejecución — edita el código fuente y vuelve a ejecutar install.sh para desplegar.

Reinicia Claude Code después de instalar. El primer inicio indexa todas las sesiones (tarda unos minutos). Los inicios posteriores son incrementales (<5 segundos).

Uso

Usa Claude Code con normalidad. Cuando el contexto de sesiones pasadas pueda ayudar, Claude buscará automáticamente. También puedes preguntar directamente:

• "¿En qué estaba trabajando la semana pasada?"

• "¿Cómo arreglé el bug de autenticación en betterclaw?"

• "Encuentra la sesión donde configuré el cloudflare tunnel"

• "¿Qué comando ejecuté para reconstruir el módulo del kernel?"

• "Muéstrame los errores que encontré mientras trabajaba en listforge"

Requisitos

• Node.js 20+

• Claude Code con soporte MCP

Datos

• Sesiones indexadas desde: ~/.claude/projects/

• Base de datos almacenada en: ~/.claude-lens/claude-lens.db

• Las sesiones de subagentes se omiten

• Las salidas de las herramientas se truncan a 500 caracteres para mantener la base de datos manejable

• Indexación incremental mediante seguimiento de mtime de los archivos

Licencia

MIT