Claude Code guarda en disco cada sesión de registro: así se indexan y recuerdan

Claude Code ha estado escribiendo un registro JSONL de solo anexión de cada sesión en ~/.claude/projects/ desde el primer día. Cada línea es un objeto JSON estructurado — rol, marca de tiempo, contenido, llamadas a herramientas — formando un registro episódico completo que se remonta a tu primera sesión. Un usuario encontró 1,026 sesiones con un total de 57MB y 76,000 turnos, todo almacenado en disco sin una forma integrada de consultarlos.

Construyendo una capa de recuerdo

La solución es un indexador de código abierto (continuity-v2, MIT) que ingiere estos registros en SQLite+FTS5 con arcos temporales entre turnos, más un servidor MCP. Desde cualquier sesión de Claude Code, ahora puedes ejecutar:

search_sessions("recuerda cuando arreglamos ese bug de autenticación el mes pasado")
recall_session("a8f2c441")
thread_recall(root_id, depth=8)

La función thread_recall realiza un recorrido BFS a través del grafo de arcos temporales para reconstruir un hilo entre sesiones. El indexador también soporta importar conversations.json de la exportación de datos de claude.ai, de modo que el historial de chat web viva en el mismo índice que las sesiones de CLI.

Solucionando el reinicio duro de la compactación

La compactación se activa cuando el contexto se llena, pero el transcript_path en la carga útil de PreCompact no siempre está poblado en el momento de disparo del hook. La solución: escribir un checkpoint en cada turno (no solo al final de la sesión) para que PreCompact siempre tenga datos frescos a los que recurrir. Luego SessionStart lee el campo source — "compact" significa que se disparó la compactación, "resume" significa reinicio de la aplicación, "startup" es una sesión nueva, "clear" es intencional. Cada uno obtiene un comportamiento diferente. Resultado neto: la compactación se convierte en un fallo de caché, no en un reinicio duro.

Conversación ascendente y proyectos similares

Sigue la discusión en curso en anthropics/claude-code#47023. Siete proyectos de memoria independientes (Bella, NEXO Brain, Cozempic, world-model-mcp, etc.) llegaron de forma independiente a los mismos requisitos. Se está elaborando una especificación formal de hooks allí.

Los hooks tardan unos cinco minutos en configurarse; el servidor MCP es un único archivo Python. El repositorio tiene licencia MIT.