claude-find

Extrae memoria profunda de todas tus sesiones de Claude Code, cuando la necesites.

Búsqueda semántica en todas tus sesiones pasadas de Claude Code. Encuentra contexto por significado y palabras clave. Busca en las transcripciones de conversación sin procesar, no en resúmenes comprimidos, por lo que Claude obtiene la imagen completa: razonamiento, restricciones, enfoques fallidos y decisiones.

Configuración

brew install bun ollama
bunx claude-find setup

setup inicia Ollama, descarga el modelo de incrustación (embedding), establece la retención de sesiones como permanente y registra el servidor MCP con Claude Code. Las sesiones se indexan en segundo plano al iniciar. Las búsquedas funcionan de inmediato y devuelven resultados progresivamente más completos a medida que continúa la indexación.

Instala Bun y Ollama, luego ejecuta bunx claude-find setup. Detecta tu plataforma y te guía a través de cualquier cosa que falte.

Uso

En cualquier sesión de Claude Code:

/find that database migration we discussed last week
/find why we chose websockets over polling
/find the session where we kept getting timeout errors
/find refactoring the payment module across all projects

Claude busca en tus sesiones pasadas de forma semántica, encuentra las conversaciones relevantes y sintetiza el contexto: qué se intentó, qué falló, qué restricciones estableciste y qué decisiones se tomaron.

Cómo funciona

1. Indexa todos los archivos JSONL de sesiones de Claude Code desde ~/.claude/projects/

2. Extrae mensajes de usuario y asistente, resúmenes compactos y rutas de archivos de las llamadas a herramientas

3. Enriquece cada fragmento con contexto de metadatos (proyecto, rama, archivos, fecha) para una mejor recuperación

4. Incrusta fragmentos de conversación usando qwen3-embedding a través de Ollama (acelerado por GPU)

5. Busca con semántica híbrida + palabras clave (FTS5) fusionadas mediante Reciprocal Rank Fusion

6. Devuelve fragmentos de conversación sin procesar para que Claude pueda sintetizar con el contexto completo

Después de actualizar, ejecuta bunx claude-find index para reconstruir el índice con las últimas mejoras.

Qué lo hace diferente

• Busca en transcripciones sin procesar. No se pierde nada mediante compresión.

• Retroactivo: funciona en todas las sesiones existentes de inmediato. No se necesitan ganchos.

• Historial permanente: la configuración deshabilita la limpieza de sesiones de 30 días de Claude Code para que tus sesiones sean buscables para siempre.

• No bloqueante: indexa en segundo plano al iniciar. Las búsquedas funcionan al instante, incluso a mitad de la indexación.

• Utiliza resúmenes compactos: la propia comprensión de sesión de Claude, potenciada en la clasificación.

• Indexa metadatos de llamadas a herramientas: busca por archivos tocados, errores encontrados.

• Rápido: Ollama + GPU mantiene la indexación rápida y con memoria limitada.

Requisitos

• Entorno de ejecución Bun

• Ollama (modelo descargado automáticamente en el primer uso)

• Claude Code

Licencia

MIT