Skip to main content
Glama

Rekindle

npm tests license Glama score

Para usuarios de Claude Code que pierden tiempo explicando de nuevo el contexto del proyecto en cada sesión.

npx rekindle init

Tu IA olvida todo entre sesiones. Rekindle soluciona eso.


Demostración de Rekindle init

Rekindle es un motor de continuidad MCP que resuelve la orientación de la sesión, no solo el almacenamiento. Oriéntate al inicio de la sesión, captura al final de la sesión, sobrevive a la compactación a mitad de sesión. Todo local, todo SQLite, cero claves API.

v0.3.0 — "Sobrevive al largo intermedio" — Sistema de captura PreCompact, bucles abiertos, seguimiento de revisiones. Notas de la versión

Inicio rápido

npx rekindle init

Esto crea un directorio .rekindle/ en tu proyecto con una base de datos SQLite, una plantilla de identidad, un directorio de capturas y un directorio de transcripciones. Luego, añade la configuración del servidor MCP para tu cliente:

Añade a ~/.claude.json:

{
  "mcpServers": {
    "rekindle": {
      "command": "npx",
      "args": ["-y", "rekindle"]
    }
  }
}

Habilita la protección PreCompact (captura el contexto antes de la compactación a mitad de sesión):

npx rekindle setup-hooks

Añade a claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "rekindle": {
      "command": "npx",
      "args": ["-y", "rekindle"]
    }
  }
}

Añade a .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "rekindle": {
      "command": "npx",
      "args": ["-y", "rekindle"]
    }
  }
}

Luego completa .rekindle/identity.md y pega las instrucciones de arranque en el archivo CLAUDE.md de tu proyecto.

La sesión 1 almacena. La sesión 2 recuerda. La sesión 10 anticipa.


Related MCP server: claude-session-continuity-mcp

El problema (43 sesiones de datos)

A lo largo de 43 sesiones, medimos lo que un asistente de IA no lograba cargar al inicio de la sesión:

Métrica

Valor

Sesiones analizadas

43

Arranques limpios (todo el contexto cargado)

33%

Fallos de alta señal (más de 5 brechas)

26%

Fallos totales de recuperación

173

Las herramientas de memoria existentes (Mem0, Letta, Zep) optimizan la precisión de la recuperación: ¿puede la IA encontrar lo que almacenó? Eso es necesario pero no suficiente. Ninguna de ellas aborda si la IA cargó el contexto correcto para esta sesión, o si puede detectar lo que se perdió.

Rekindle resuelve la orientación de la sesión: cargando la identidad, el contexto reciente, el estado de la memoria y las advertencias de contexto faltante antes de que el asistente comience a trabajar.

Consulta docs/gap-analysis.md para ver el conjunto de datos de investigación completo.


Qué hace

Arranque: orientación al inicio de la sesión

boot_report ejecuta una canalización de orientación antes de que comience cualquier trabajo:

boot_report
  +-- Read identity document (who am I working with?)
  +-- Scan memory stats (what do I know?)
  +-- Find latest checkpoint (where did we leave off?)
  +-- Read last transcript (what actually happened?)
  +-- Surface open loops (what needs follow-up?)
  +-- Surface PreCompact captures (what survived compaction?)
  +-- Detect gaps (what am I missing?)
  +-- Calculate orientation score (how oriented am I?)
  --> "Carrying forward: [context loaded, gaps identified, score: 80/100]"

Sobrevive al largo intermedio: captura PreCompact (v0.3)

La compactación a mitad de sesión destruye las cadenas de razonamiento, los enfoques fallidos, la textura relacional y el tono. El hook PreCompact se dispara automáticamente antes de la compactación y guarda lo que de otro modo se perdería:

PreCompact hook fires
  +-- Parse JSONL transcript (last N messages)
  +-- Write raw Markdown capture (.rekindle/captures/)
  +-- Write structured JSON snapshot (decisions, open loops, files)
  +-- Update manifest for cheap listing
  --> boot_report surfaces captures on next session start
  --> end_session warns if captures exist but weren't reviewed

Tres modos de lectura controlan el coste de tokens:

  • summary — un párrafo, económico

  • structured — decisiones/bucles/advertencias, moderado

  • raw — extracto completo de la transcripción, costoso (solo cuando es necesario)

Captura: cierra el bucle al final de la sesión

end_session almacena registros de continuidad estructurados, no solo un resumen:

Campo

Qué captura

checkpoint

Dónde nos quedamos (obligatorio)

decisions

Qué se decidió y por qué

open_loops

Tareas o preguntas sin resolver

constraints

Límites que no deben violarse

relational_delta

Qué cambió en la relación de trabajo

next_session_focus

Dónde retomar la próxima sesión

preferences

Nuevas preferencias de usuario aprendidas

warnings

Cosas que la próxima sesión debería vigilar

Todos los registros se almacenan con metadatos de type, source y session_id. El siguiente boot_report carga el punto de control automáticamente.

Entre sesiones: buscar y gestionar

Herramienta

Descripción

store_memory

Almacenar con contenido, categoría, importancia (1-10) y alcance del proyecto

search_memory

Búsqueda de texto completo con ranking BM25, potenciado por importancia

list_memories

Explorar memorias, las más recientes primero. Filtrar por categoría o proyecto

delete_memory

Eliminar por ID

update_memory

Actualizar contenido, categoría o importancia

list_captures

Listar capturas PreCompact (opcionalmente filtrar por sesión)

read_capture

Leer una captura en modo resumen, estructurado o crudo

capture_now

Capturar manualmente el contexto de la sesión actual bajo demanda

Categorías: preference lesson context relationship general


¿Por qué no solo CLAUDE.md?

Un archivo estático es pasivo. Tu IA lo lee, pero no puede buscarlo, clasificarlo, rastrear lo que se ha recuperado o decirte qué falta. Rekindle añade:

  • Búsqueda — texto completo con ranking ponderado por importancia

  • Estructura — categorización y alcance de proyecto a través de memorias

  • Orientación — carga proactiva de contexto al arrancar, no solo recuperación bajo demanda

  • Detección de brechas — marca identidad faltante, categorías vacías, datos obsoletos

  • Puntuación — lista de verificación transparente para que sepas qué tan orientada está la IA

  • Captura de sesión — cierre estructurado con puntos de control, decisiones y bucles abiertos

  • Supervivencia a la compactación — las capturas PreCompact preservan lo que los resúmenes aplanan


Aspectos destacados de la v0.3.0

  • 10 herramientas MCP — se añadieron list_captures, read_capture, capture_now

  • Sistema de captura PreCompact — preservación automática del contexto antes de la compactación a mitad de sesión

  • Bucles abiertos en boot_report — muestra tareas sin resolver de sesiones anteriores

  • Seguimiento de revisiones — capturas marcadas como revisadas después de read_capture; end_session advierte si no están revisadas

  • Configuración de hooks — npx rekindle setup-hooks configura el hook PreCompact de Claude Code

  • Auto-descubrimiento — capture_now descubre la transcripción de la sesión sin rutas manuales

  • 101 pruebas automatizadas — unidad, integración, gestor de capturas, configuración de hooks


Comandos CLI

Comando

Descripción

npx rekindle init

Configurar .rekindle/ en el directorio actual

npx rekindle init --global

Configurar en el directorio home

npx rekindle init --with-hooks

Init + configurar hook PreCompact

npx rekindle setup-hooks

Configurar hook PreCompact (independiente)

npx rekindle precompact-capture

Capturar contexto antes de la compactación (hook)

npx rekindle capture-now

Capturar manualmente el contexto de la sesión actual

npx rekindle

Iniciar servidor MCP (usado por Claude Code)


Instalar desde el código fuente

git clone https://github.com/Skitchy/rekindle.git
cd rekindle
npm install
npm run build
node dist/init/cli.js init

El comando setup-hooks escribe esto en .claude/settings.local.json:

{
  "hooks": {
    "PreCompact": [
      {
        "matcher": "auto",
        "hooks": [
          {
            "type": "command",
            "command": "npx rekindle precompact-capture",
            "timeout": 60
          }
        ]
      },
      {
        "matcher": "manual",
        "hooks": [
          {
            "type": "command",
            "command": "npx rekindle precompact-capture",
            "timeout": 60
          }
        ]
      }
    ]
  }
}

El hook recibe el contexto de la sesión en stdin (session_id, transcript_path, cwd, hook_event_name) y escribe las capturas en .rekindle/captures/.

Variable

Predeterminado

Descripción

REKINDLE_PRECOMPACT_MAX_MESSAGES

80

Máximo de mensajes a capturar

REKINDLE_PRECOMPACT_MAX_CHARS

120000

Máximo de caracteres a capturar

REKINDLE_BASE_DIR

Auto-detectado

Directorio base para .rekindle/

  • Todos los datos son locales. No se envía nada a servidores externos.

  • Sin llamadas de red. El servidor MCP se comunica a través de stdio. Sin HTTP, sin telemetría, sin analíticas.

  • Las transcripciones contienen texto de conversación. No habilites la captura de transcripciones si tus sesiones contienen secretos o credenciales.

  • La instalación del hook es opcional. setup-hooks debe ejecutarse explícitamente (no se instala automáticamente con init).

  • La base de datos SQLite es un archivo normal. No está cifrada. Usa cifrado de disco a nivel de SO si es necesario.

  • .rekindle/ está en gitignore. El comando init maneja esto automáticamente.

  • boot_report lee archivos locales. Las rutas no están aisladas (sandboxed). Úsalo solo con clientes MCP y prompts en los que confíes.

Compatibilidad

Cliente

Transporte

Estado

Claude Code (macOS)

stdio

Probado

Claude Code (Linux/WSL2)

stdio

Probado

Claude Code (Windows)

stdio

Probado

Claude Desktop

stdio

Compatible (mismo formato de configuración MCP)

Cursor

stdio

Compatible (mismo formato de configuración MCP)

Cualquier cliente MCP stdio

stdio

Compatible

rekindle/
  src/
    index.ts          MCP server entry point
    server.ts         Server setup, tool registration (10 tools)
    storage/
      sqlite.ts       SQLite + FTS5, schema migration, sessions
    orientation/
      types.ts        OrientationResult, Gap, ScoreItem
      GapDetector.ts  Structural gap detection (8 codes)
      Scorer.ts       Orientation scoring (6 criteria, 100pts)
      OrientationService.ts   Orchestrator
      OrientationRenderer.ts  Markdown + JSON output
    captures/
      types.ts        CaptureEntry, StructuredSnapshot, HookInput
      CaptureManager.ts   Parse, capture, list, read, review tracking
      discover-transcript.ts  Auto-discover session transcripts
      precompact-capture.ts   CLI hook entry point
      capture-now.ts          Manual capture CLI
    tools/
      boot-report.ts  Orientation + open loops + capture awareness
      end-session.ts  Structured session close + capture warning
      list-captures.ts  List PreCompact captures
      read-capture.ts   Read captures in 3 modes
      capture-now.ts    Model-triggered manual capture
      store.ts search.ts list.ts delete.ts update.ts
    init/
      cli.ts scaffold.ts setup-hooks.ts templates/

Almacenamiento: SQLite + FTS5 vía better-sqlite3. Ranking BM25 potenciado por importancia. Registros tipados con type, source, session_id.

Transporte: stdio (MCP estándar). Funciona con Claude Code de forma inmediata.

Pruebas

npm test

101 pruebas: CRUD de almacenamiento + ranking FTS5, dominio de orientación (detección de brechas, puntuación, servicio, renderizado), gestor de capturas (análisis, límites, seguimiento de revisiones, formato), configuración de hooks (esquema, idempotencia) e integración MCP (las 10 herramientas).

Hoja de ruta

v0.4: "Piensa en redes" — Activación por propagación, búsqueda semántica mediante embeddings, herramientas de análisis de brechas, arnés de evaluación.

Licencia

MIT

Available Tools

10 tools
boot_reportA

Generate a session orientation report. Read-only — does not modify any stored data. Reads the identity document from disk, scans the memory database for statistics and the latest checkpoint, finds the most recent transcript file, detects structural gaps (missing identity, stale memories, no checkpoint, etc.), and calculates a 0-100 orientation score across 6 criteria. Also surfaces open loops from prior sessions and any PreCompact captures that preserve context from compacted sessions. Workflow: call boot_report first thing every session, before any substantive work. Orientation scores are structural checks, not guarantees that every relevant context item was loaded.

Inputs: identity_path (required), transcript_dir (required), project.

capture_nowA

Manually capture current session context to .rekindle/captures/. Use this when you want to preserve the current conversation state — before a complex operation, when context feels at risk, or when the user requests it. Produces the same artifact as the automatic PreCompact hook but triggered on demand. session_id and transcript_path are optional — if omitted, the most recent transcript is discovered automatically.

Inputs: reason, session_id, transcript_path.

delete_memoryA

Permanently delete a single memory from the local SQLite database by its ID. This action is irreversible — the row and its full-text search index entry are removed immediately. Use when a memory is outdated, incorrect, or no longer relevant. Returns {success: true} if the memory was found and deleted, or {success: false, message: 'Memory not found'} if the ID does not exist. Does not affect other memories or session records.

Inputs: id (required), provenance.

end_sessionA

Capture a structured session handoff. Writes multiple records to the local SQLite database: one checkpoint (required), plus optional decisions, open loops, preferences, constraints, warnings, relational delta, and next session focus. Each record is stored with a typed 'type' column (not content prefixes) and linked to a session record via session_id. Also creates a session row in the sessions table with a summary, orientation score, and gap count. The checkpoint is retrievable by boot_report on the next session start. All records are searchable via search_memory and list_memories. Workflow: call end_session at the end of every substantive session so the next session can pick up the thread.

Inputs: checkpoint (required), project, warnings, decisions, +8 more.

list_capturesA

List PreCompact captures for the current or recent sessions. PreCompact captures preserve context that would otherwise be lost during mid-session compaction. Workflow: if boot_report lists PreCompact captures, call list_captures then read_capture to recover pre-compaction context before relying on the checkpoint. Before calling end_session, check for unreviewed captures.

Inputs: session_id.

list_memoriesA

List stored memories from the local SQLite database, ordered newest first. Unlike search_memory, this does not require a query — it returns all memories matching the optional filters. Read-only; does not modify any data. Use to browse what has been stored, audit memory contents, or check memory counts per category or project. Returns an array of memories with id, content, category, importance, project, and created_at.

Inputs: limit, project, category.

read_captureA

Read a PreCompact capture by ID. Use this to recover context that was lost during mid-session compaction. Three modes control token cost: 'summary' (one paragraph, cheap), 'structured' (decisions/loops/warnings, moderate), 'raw' (full transcript excerpt, expensive — only when summary or structured is insufficient). Workflow: read recovered captures before relying on the latest checkpoint; start with the lightest mode that answers your question.

Inputs: id (required), mode.

search_memoryA

Search stored memories using SQLite full-text search (FTS5). Returns results ranked by relevance with higher-importance memories boosted. Each search increments the retrieval_count on matched memories, tracking which memories are accessed most. Use at session start to load relevant context, or mid-session to recall specific information. Returns an array of matching memories with id, content, category, importance, project, created_at, and retrieval_count. Returns an empty array if no matches are found.

Inputs: query (required), limit, project, category.

store_memoryA

Store a new memory in the local SQLite database. Creates a persistent row with an auto-generated UUID, timestamp, and the provided content. Use for preferences, lessons learned, project context, relationship notes, or general information worth remembering across sessions. Memories persist across sessions and are surfaced by boot_report, search_memory, and list_memories. Returns the generated ID on success. Does not deduplicate — calling twice with the same content creates two separate memories.

Inputs: content (required), project, category, importance, +1 more.

update_memoryA

Update an existing memory in the local SQLite database. Modifies only the fields you provide — omitted fields are left unchanged. The updated_at timestamp is set automatically. If content is changed, the full-text search index is rebuilt for this memory. Returns the full updated memory object on success, or {success: false, message: 'Memory not found'} if the ID does not exist. Use to correct inaccurate memories, adjust importance, or reclassify a memory's category without deleting and re-creating it.

Inputs: id (required), content, category, importance, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 10 tools

    Disambiguation4/5

    Memory operations (store/update/delete/list/search) are clearly distinct, and capture operations (capture_now/list_captures/read_capture) form a coherent group. There is some functional overlap between end_session, capture_now, and store_memory since all persist context, but the descriptions draw clear lines between structured handoffs, ad-hoc snapshots, and discrete memories.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (store_memory, delete_memory, list_captures, read_capture, end_session), with memory tools consistently suffixed by _memory/_memories. Deviations like boot_report (noun form) and capture_now (verb_adverb) are minor and still readable.

    Tool Count5/5

    Ten tools is well-scoped for a session-context/memory server, covering memory CRUD, search, session handoff, and capture retrieval without redundancy. Each tool has a defensible role in the workflow.

    Completeness4/5

    Memory lifecycle is fully covered (create, update, delete, list, search) and captures are readable/listable. Minor gaps exist: no get-by-ID for a single memory, no deletion of captures or sessions, and session history is only exposed indirectly via boot_report rather than a list_sessions/read_session pair.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI coding assistants like Claude Code, Cursor, and Codex to share chat logs, terminal history, and session context with each other. Eliminates the need to re-explain context when switching between different AI coding tools.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      2-5x longer Claude Code sessions before compaction. Saves 30-40% on input token costs. Remembers your rules and corrections so Claude stops repeating mistakes after compaction. Auto-runs in the background, just install once and forget about it.
      1,207 PyPI
      430
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Persistent memory for Claude Code — a self-evolving knowledge layer that survives across sessions, grows from every conversation, and surfaces relevant context automatically.
      14
      MIT