Skip to main content
Glama

Rekindle

npm tests license Glama score

Für Claude Code-Benutzer, die Zeit damit verlieren, bei jeder Sitzung den Projektkontext neu zu erklären.

npx rekindle init

Deine KI vergisst alles zwischen den Sitzungen. Rekindle behebt das.


Rekindle init demo

Rekindle ist eine MCP-Kontinuitäts-Engine, die Sitzungsorientierung löst, nicht nur Speicherung. Orientiere dich zu Sitzungsbeginn, erfasse zu Sitzungsende, überlebe die Komprimierung während der Sitzung. Alles lokal, alles SQLite, null API-Schlüssel.

v0.3.0 — "Überlebe die lange Mitte" — PreCompact-Erfassungssystem, offene Schleifen, Review-Tracking. Versionshinweise

Schnellstart

npx rekindle init

Dies erstellt .rekindle/ in deinem Projekt mit einer SQLite-Datenbank, Identitätsvorlage, Erfassungsverzeichnis und Transkriptverzeichnis. Füge dann die MCP-Server-Konfiguration für deinen Client hinzu:

In ~/.claude.json hinzufügen:

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

Aktivieren des PreCompact-Schutzes (erfasst den Kontext vor der Komprimierung während der Sitzung):

npx rekindle setup-hooks

In claude_desktop_config.json hinzufügen (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

In .cursor/mcp.json im Projektstammverzeichnis hinzufügen:

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

Fülle dann .rekindle/identity.md aus und füge die Boot-Anweisungen in die CLAUDE.md deines Projekts ein.

Sitzung 1 speichert. Sitzung 2 erinnert sich. Sitzung 10 antizipiert.


Related MCP server: claude-session-continuity-mcp

Das Problem (43 Sitzungen an Daten)

Über 43 Sitzungen hinweg haben wir gemessen, was ein KI-Assistent zu Sitzungsbeginn nicht geladen hat:

Metrik

Wert

Analysierte Sitzungen

43

Saubere Starts (gesamter Kontext geladen)

33%

Hochsignifikante Fehler (5+ Lücken)

26%

Gesamte Abruffehler

173

Bestehende Memory-Tools (Mem0, Letta, Zep) optimieren auf Abrufgenauigkeit: Kann die KI finden, was sie gespeichert hat? Das ist notwendig, aber nicht ausreichend. Keines davon adressiert, ob die KI den richtigen Kontext für diese Sitzung geladen hat oder ob sie erkennen kann, was ihr fehlt.

Rekindle löst die Sitzungsorientierung: Laden von Identität, aktuellem Kontext, Memory-Gesundheit und Warnungen bei fehlendem Kontext, bevor der Assistent mit der Arbeit beginnt.

Siehe docs/gap-analysis.md für den vollständigen Forschungsdatensatz.


Was es tut

Boot: Orientierung zu Sitzungsbeginn

boot_report führt eine Orientierungspipeline aus, bevor die Arbeit beginnt:

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]"

Überlebe die lange Mitte: PreCompact-Erfassung (v0.3)

Die Komprimierung während der Sitzung zerstört Argumentationsketten, gescheiterte Ansätze, relationale Textur und Tonfall. Der PreCompact-Hook wird automatisch vor der Komprimierung ausgelöst und speichert, was sonst verloren gehen würde:

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

Drei Lesemodi steuern die Token-Kosten:

  • summary — ein Absatz, günstig

  • structured — Entscheidungen/Schleifen/Warnungen, moderat

  • raw — vollständiger Transkriptauszug, teuer (nur bei Bedarf)

Erfassung: Schließe den Kreis am Sitzungsende

end_session speichert strukturierte Kontinuitätsdatensätze — nicht nur eine Zusammenfassung:

Feld

Was es erfasst

checkpoint

Wo wir aufgehört haben (erforderlich)

decisions

Was wurde entschieden und warum

open_loops

Ungelöste Aufgaben oder Fragen

constraints

Grenzen, die nicht verletzt werden dürfen

relational_delta

Was sich in der Arbeitsbeziehung geändert hat

next_session_focus

Wo in der nächsten Sitzung fortgefahren werden soll

preferences

Neue gelernte Benutzerpräferenzen

warnings

Dinge, auf die die nächste Sitzung achten sollte

Alle Datensätze werden mit type-, source- und session_id-Metadaten gespeichert. Der nächste boot_report lädt den Checkpoint automatisch.

Zwischen Sitzungen: Suchen und Verwalten

Tool

Beschreibung

store_memory

Speichern mit Inhalt, Kategorie, Wichtigkeit (1-10) und Projektumfang

search_memory

Volltextsuche mit BM25-Ranking, verstärkt durch Wichtigkeit

list_memories

Durchsuche Erinnerungen, neueste zuerst. Filtern nach Kategorie oder Projekt

delete_memory

Löschen nach ID

update_memory

Aktualisieren von Inhalt, Kategorie oder Wichtigkeit

list_captures

Auflisten von PreCompact-Erfassungen (optional nach Sitzung filtern)

read_capture

Lesen einer Erfassung im Summary-, Structured- oder Raw-Modus

capture_now

Manuelles Erfassen des aktuellen Sitzungskontexts bei Bedarf

Kategorien: preference lesson context relationship general


Warum nicht einfach CLAUDE.md?

Eine statische Datei ist passiv. Deine KI liest sie, aber sie kann sie nicht durchsuchen, ranken, nachverfolgen, was abgerufen wurde, oder dir sagen, was fehlt. Rekindle fügt hinzu:

  • Suche — Volltext mit Wichtigkeits-gewichtetem Ranking

  • Struktur — Kategorie- und Projekt-Scoping über Erinnerungen hinweg

  • Orientierung — Proaktives Laden des Kontexts beim Booten, nicht nur Abruf bei Bedarf

  • Lückenerkennung — Markiert fehlende Identität, leere Kategorien, veraltete Daten

  • Scoring — Transparente Checkliste, damit du weißt, wie orientiert die KI ist

  • Sitzungserfassung — Strukturierter Abschluss mit Checkpoints, Entscheidungen und offenen Schleifen

  • Komprimierungsüberleben — PreCompact-Erfassungen bewahren, was Zusammenfassungen abflachen


v0.3.0 Highlights

  • 10 MCP-Tools — hinzugefügt: list_captures, read_capture, capture_now

  • PreCompact-Erfassungssystem — automatische Kontextbewahrung vor der Komprimierung während der Sitzung

  • Offene Schleifen im boot_report — zeigt ungelöste Aufgaben aus früheren Sitzungen an

  • Review-Tracking — Erfassungen werden nach read_capture als überprüft markiert; end_session warnt, falls nicht überprüft

  • Hook-Setup — npx rekindle setup-hooks konfiguriert den Claude Code PreCompact-Hook

  • Auto-Discovery — capture_now erkennt das Sitzungstranskript ohne manuelle Pfade

  • 101 automatisierte Tests — Unit, Integration, Capture Manager, Hook-Setup


CLI-Befehle

Befehl

Beschreibung

npx rekindle init

Einrichten von .rekindle/ im aktuellen Verzeichnis

npx rekindle init --global

Einrichten im Home-Verzeichnis

npx rekindle init --with-hooks

Init + Konfigurieren des PreCompact-Hooks

npx rekindle setup-hooks

Konfigurieren des PreCompact-Hooks (eigenständig)

npx rekindle precompact-capture

Erfassen des Kontexts vor der Komprimierung (Hook)

npx rekindle capture-now

Manuelles Erfassen des aktuellen Sitzungskontexts

npx rekindle

Starten des MCP-Servers (verwendet von Claude Code)


Installation aus dem Quellcode

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

Der Befehl setup-hooks schreibt dies in .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
          }
        ]
      }
    ]
  }
}

Der Hook empfängt den Sitzungskontext über stdin (session_id, transcript_path, cwd, hook_event_name) und schreibt Erfassungen in .rekindle/captures/.

Variable

Standard

Beschreibung

REKINDLE_PRECOMPACT_MAX_MESSAGES

80

Maximale Anzahl der zu erfassenden Nachrichten

REKINDLE_PRECOMPACT_MAX_CHARS

120000

Maximale Anzahl der zu erfassenden Zeichen

REKINDLE_BASE_DIR

Automatisch erkannt

Basisverzeichnis für .rekindle/

  • Alle Daten sind lokal. Nichts wird an externe Server gesendet.

  • Keine Netzwerkaufrufe. Der MCP-Server kommuniziert über stdio. Kein HTTP, keine Telemetrie, keine Analytik.

  • Transkripte enthalten Konversationstext. Aktiviere die Transkripterfassung nicht, wenn deine Sitzungen Geheimnisse oder Anmeldedaten enthalten.

  • Hook-Installation ist Opt-in. setup-hooks muss explizit ausgeführt werden (wird nicht automatisch durch init installiert).

  • SQLite-Datenbank ist eine reguläre Datei. Nicht verschlüsselt. Verwende bei Bedarf eine Festplattenverschlüsselung auf Betriebssystemebene.

  • .rekindle/ ist gitignored. Der Init-Befehl erledigt dies automatisch.

  • boot_report liest lokale Dateien. Pfade sind nicht in einer Sandbox. Nur mit MCP-Clients und Prompts verwenden, denen du vertraust.

Kompatibilität

Client

Transport

Status

Claude Code (macOS)

stdio

Getestet

Claude Code (Linux/WSL2)

stdio

Getestet

Claude Code (Windows)

stdio

Getestet

Claude Desktop

stdio

Kompatibel (gleiches MCP-Konfigurationsformat)

Cursor

stdio

Kompatibel (gleiches MCP-Konfigurationsformat)

Jeder MCP stdio-Client

stdio

Kompatibel

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/

Speicherung: SQLite + FTS5 via better-sqlite3. BM25-Ranking verstärkt durch Wichtigkeit. Typisierte Datensätze mit type, source, session_id.

Transport: stdio (Standard-MCP). Funktioniert sofort mit Claude Code.

Tests

npm test

101 Tests: Speicher-CRUD + FTS5-Ranking, Orientierungsdomäne (Lückenerkennung, Scoring, Service, Rendering), Capture Manager (Parsing, Limits, Review-Tracking, Formatierung), Hook-Setup (Schema, Idempotenz) und MCP-Integration (alle 10 Tools).

Roadmap

v0.4: "Es denkt in Netzwerken" — Spreading Activation, semantische Suche via Embeddings, Lückenanalyse-Tools, Eval-Harness.

Lizenz

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