Skip to main content
Glama

Rekindle

npm tests license Glama score

세션마다 프로젝트 컨텍스트를 다시 설명하느라 시간을 낭비하는 Claude Code 사용자를 위한 도구입니다.

npx rekindle init

AI는 세션 사이에 모든 것을 잊어버립니다. Rekindle이 이를 해결합니다.


Rekindle init demo

Rekindle은 단순한 저장을 넘어 세션 지향성(session orientation) 문제를 해결하는 MCP 연속성 엔진입니다. 세션 시작 시 방향을 잡고, 세션 종료 시 캡처하며, 세션 중간의 압축 과정에서도 살아남습니다. 모두 로컬에서 작동하며, SQLite를 사용하고, API 키가 전혀 필요 없습니다.

v0.3.0 — "긴 중간 과정을 견뎌내다" — PreCompact 캡처 시스템, 열린 루프, 검토 추적 기능. 릴리스 노트

빠른 시작

npx rekindle init

이 명령은 프로젝트 내에 SQLite 데이터베이스, ID 템플릿, 캡처 디렉토리 및 트랜스크립트 디렉토리가 포함된 .rekindle/을 생성합니다. 그런 다음 클라이언트에 대한 MCP 서버 설정을 추가하세요:

~/.claude.json에 추가:

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

PreCompact 보호 활성화 (세션 중간 압축 전에 컨텍스트 캡처):

npx rekindle setup-hooks

claude_desktop_config.json에 추가 (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

프로젝트 루트의 .cursor/mcp.json에 추가:

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

그런 다음 .rekindle/identity.md를 작성하고 부팅 지침을 프로젝트의 CLAUDE.md에 붙여넣으세요.

세션 1은 저장합니다. 세션 2는 기억합니다. 세션 10은 예측합니다.


Related MCP server: claude-session-continuity-mcp

문제점 (43개의 세션 데이터)

43개의 세션을 분석하여 AI 어시스턴트가 세션 시작 시 로드하지 못한 항목을 측정했습니다:

지표

값

분석된 세션

43

깔끔한 부팅 (모든 컨텍스트 로드됨)

33%

고신호 실패 (5개 이상의 누락)

26%

총 검색 실패

173

기존 메모리 도구(Mem0, Letta, Zep)는 검색 정확도에 최적화되어 있습니다. 즉, AI가 저장한 것을 찾을 수 있는가에 집중합니다. 이는 필요하지만 충분하지는 않습니다. 이 도구들 중 어느 것도 AI가 이번 세션에 적절한 컨텍스트를 로드했는지, 혹은 놓친 부분을 감지할 수 있는지에 대해서는 다루지 않습니다.

Rekindle은 세션 지향성 문제를 해결합니다. 어시스턴트가 작업을 시작하기 전에 ID, 최근 컨텍스트, 메모리 상태 및 누락된 컨텍스트 경고를 로드합니다.

전체 연구 데이터셋은 docs/gap-analysis.md를 참조하세요.


주요 기능

부팅: 세션 시작 시 방향 잡기

boot_report는 작업이 시작되기 전에 방향 설정 파이프라인을 실행합니다:

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

긴 중간 과정 견디기: PreCompact 캡처 (v0.3)

세션 중간의 압축은 추론 체인, 실패한 접근 방식, 관계적 맥락, 어조를 파괴합니다. PreCompact 훅은 압축 직전에 자동으로 실행되어 그렇지 않으면 손실될 정보를 저장합니다:

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

토큰 비용을 제어하는 세 가지 읽기 모드:

  • summary — 한 문단, 저렴함

  • structured — 결정/루프/경고, 보통

  • raw — 전체 트랜스크립트 발췌, 비쌈 (필요할 때만 사용)

캡처: 세션 종료 시 루프 닫기

end_session은 단순한 요약이 아닌 구조화된 연속성 기록을 저장합니다:

필드

캡처 내용

checkpoint

중단 지점 (필수)

decisions

결정된 사항과 이유

open_loops

해결되지 않은 작업이나 질문

constraints

위반해서는 안 되는 경계

relational_delta

작업 관계에서 변경된 사항

next_session_focus

다음 세션에서 재개할 지점

preferences

새로 학습된 사용자 선호도

warnings

다음 세션에서 주의해야 할 사항

모든 기록은 type, source, session_id 메타데이터와 함께 저장됩니다. 다음 boot_report는 체크포인트를 자동으로 로드합니다.

세션 간: 검색 및 관리

도구

설명

store_memory

내용, 카테고리, 중요도(1-10), 프로젝트 범위를 지정하여 저장

search_memory

중요도에 따라 가중치가 부여된 BM25 랭킹 기반의 전체 텍스트 검색

list_memories

메모리 탐색 (최신순). 카테고리나 프로젝트별 필터링

delete_memory

ID로 삭제

update_memory

내용, 카테고리 또는 중요도 업데이트

list_captures

PreCompact 캡처 목록 (세션별 필터링 가능)

read_capture

요약, 구조화 또는 원본 모드로 캡처 읽기

capture_now

필요 시 현재 세션 컨텍스트를 수동으로 캡처

카테고리: preference lesson context relationship general


왜 CLAUDE.md만으로는 부족한가요?

정적 파일은 수동적입니다. AI가 읽을 수는 있지만, 검색하거나 순위를 매기거나, 무엇이 검색되었는지 추적하거나, 무엇이 누락되었는지 알려줄 수 없습니다. Rekindle은 다음을 추가합니다:

  • 검색 — 중요도 가중치 랭킹이 포함된 전체 텍스트 검색

  • 구조 — 메모리 전반에 걸친 카테고리 및 프로젝트 범위 지정

  • 방향 설정 — 요청 시 검색이 아닌, 부팅 시 선제적인 컨텍스트 로드

  • 누락 감지 — 누락된 ID, 빈 카테고리, 오래된 데이터 플래그 지정

  • 점수 산정 — AI가 얼마나 잘 방향을 잡았는지 알 수 있는 투명한 체크리스트

  • 세션 캡처 — 체크포인트, 결정 사항, 열린 루프를 포함한 구조화된 종료

  • 압축 생존 — 요약으로 평탄화되는 정보를 보존하는 PreCompact 캡처


v0.3.0 하이라이트

  • 10개의 MCP 도구 — list_captures, read_capture, capture_now 추가

  • PreCompact 캡처 시스템 — 세션 중간 압축 전 자동 컨텍스트 보존

  • boot_report의 열린 루프 — 이전 세션의 미해결 작업 표시

  • 검토 추적 — read_capture 후 검토된 것으로 표시; end_session 시 미검토 항목 경고

  • 훅 설정 — npx rekindle setup-hooks로 Claude Code PreCompact 훅 구성

  • 자동 발견 — capture_now가 수동 경로 없이 세션 트랜스크립트 발견

  • 101개의 자동화된 테스트 — 단위, 통합, 캡처 관리자, 훅 설정 테스트


CLI 명령어

명령어

설명

npx rekindle init

현재 디렉토리에 .rekindle/ 설정

npx rekindle init --global

홈 디렉토리에 설정

npx rekindle init --with-hooks

초기화 + PreCompact 훅 구성

npx rekindle setup-hooks

PreCompact 훅 구성 (독립 실행형)

npx rekindle precompact-capture

압축 전 컨텍스트 캡처 (훅)

npx rekindle capture-now

현재 세션 컨텍스트 수동 캡처

npx rekindle

MCP 서버 시작 (Claude Code에서 사용)


소스에서 설치

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

setup-hooks 명령어는 다음을 .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
          }
        ]
      }
    ]
  }
}

훅은 stdin을 통해 세션 컨텍스트(session_id, transcript_path, cwd, hook_event_name)를 수신하고 .rekindle/captures/에 캡처를 작성합니다.

변수

기본값

설명

REKINDLE_PRECOMPACT_MAX_MESSAGES

80

캡처할 최대 메시지 수

REKINDLE_PRECOMPACT_MAX_CHARS

120000

캡처할 최대 문자 수

REKINDLE_BASE_DIR

자동 감지

.rekindle/의 기본 디렉토리

  • 모든 데이터는 로컬에 저장됩니다. 외부 서버로 전송되는 데이터는 없습니다.

  • 네트워크 호출이 없습니다. MCP 서버는 stdio를 통해 통신합니다. HTTP, 텔레메트리, 분석 도구가 없습니다.

  • 트랜스크립트에는 대화 텍스트가 포함됩니다. 세션에 비밀번호나 자격 증명이 포함된 경우 트랜스크립트 캡처를 활성화하지 마세요.

  • 훅 설치는 선택 사항입니다. setup-hooks는 명시적으로 실행해야 합니다 (init 시 자동 설치되지 않음).

  • SQLite 데이터베이스는 일반 파일입니다. 암호화되지 않습니다. 필요한 경우 OS 수준의 디스크 암호화를 사용하세요.

  • .rekindle/은 gitignore 처리됩니다. init 명령어가 이를 자동으로 처리합니다.

  • boot_report는 로컬 파일을 읽습니다. 경로는 샌드박스 처리되지 않습니다. 신뢰할 수 있는 MCP 클라이언트 및 프롬프트에서만 사용하세요.

호환성

클라이언트

전송 방식

상태

Claude Code (macOS)

stdio

테스트 완료

Claude Code (Linux/WSL2)

stdio

테스트 완료

Claude Code (Windows)

stdio

테스트 완료

Claude Desktop

stdio

호환 (동일한 MCP 구성 형식)

Cursor

stdio

호환 (동일한 MCP 구성 형식)

모든 MCP stdio 클라이언트

stdio

호환

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/

저장소: better-sqlite3를 통한 SQLite + FTS5. 중요도에 따라 가중치가 부여된 BM25 랭킹. type, source, session_id를 포함한 타입 지정 기록.

전송: stdio (표준 MCP). Claude Code와 즉시 작동합니다.

테스트

npm test

101개의 테스트: 저장소 CRUD + FTS5 랭킹, 방향 설정 도메인(누락 감지, 점수 산정, 서비스, 렌더링), 캡처 관리자(파싱, 제한, 검토 추적, 포맷팅), 훅 설정(스키마, 멱등성), MCP 통합(10개 도구 전체).

로드맵

v0.4: "네트워크로 사고하다" — 확산 활성화, 임베딩을 통한 의미론적 검색, 격차 분석 도구, 평가 하네스.

라이선스

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