Rekindle
Rekindle
세션마다 프로젝트 컨텍스트를 다시 설명하느라 시간을 낭비하는 Claude Code 사용자를 위한 도구입니다.
npx rekindle initAI는 세션 사이에 모든 것을 잊어버립니다. Rekindle이 이를 해결합니다.

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-hooksclaude_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은 단순한 요약이 아닌 구조화된 연속성 기록을 저장합니다:
필드 | 캡처 내용 |
| 중단 지점 (필수) |
| 결정된 사항과 이유 |
| 해결되지 않은 작업이나 질문 |
| 위반해서는 안 되는 경계 |
| 작업 관계에서 변경된 사항 |
| 다음 세션에서 재개할 지점 |
| 새로 학습된 사용자 선호도 |
| 다음 세션에서 주의해야 할 사항 |
모든 기록은 type, source, session_id 메타데이터와 함께 저장됩니다. 다음 boot_report는 체크포인트를 자동으로 로드합니다.
세션 간: 검색 및 관리
도구 | 설명 |
| 내용, 카테고리, 중요도(1-10), 프로젝트 범위를 지정하여 저장 |
| 중요도에 따라 가중치가 부여된 BM25 랭킹 기반의 전체 텍스트 검색 |
| 메모리 탐색 (최신순). 카테고리나 프로젝트별 필터링 |
| ID로 삭제 |
| 내용, 카테고리 또는 중요도 업데이트 |
| PreCompact 캡처 목록 (세션별 필터링 가능) |
| 요약, 구조화 또는 원본 모드로 캡처 읽기 |
| 필요 시 현재 세션 컨텍스트를 수동으로 캡처 |
카테고리: 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 명령어
명령어 | 설명 |
| 현재 디렉토리에 |
| 홈 디렉토리에 설정 |
| 초기화 + PreCompact 훅 구성 |
| PreCompact 훅 구성 (독립 실행형) |
| 압축 전 컨텍스트 캡처 (훅) |
| 현재 세션 컨텍스트 수동 캡처 |
| MCP 서버 시작 (Claude Code에서 사용) |
소스에서 설치
git clone https://github.com/Skitchy/rekindle.git
cd rekindle
npm install
npm run build
node dist/init/cli.js initsetup-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/에 캡처를 작성합니다.
변수 | 기본값 | 설명 |
|
| 캡처할 최대 메시지 수 |
|
| 캡처할 최대 문자 수 |
| 자동 감지 |
|
모든 데이터는 로컬에 저장됩니다. 외부 서버로 전송되는 데이터는 없습니다.
네트워크 호출이 없습니다. 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 test101개의 테스트: 저장소 CRUD + FTS5 랭킹, 방향 설정 도메인(누락 감지, 점수 산정, 서비스, 렌더링), 캡처 관리자(파싱, 제한, 검토 추적, 포맷팅), 훅 설정(스키마, 멱등성), MCP 통합(10개 도구 전체).
로드맵
v0.4: "네트워크로 사고하다" — 확산 활성화, 임베딩을 통한 의미론적 검색, 격차 분석 도구, 평가 하네스.
라이선스
MIT
Available Tools
10 toolsboot_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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Project memory for every AI. Pick up where you left off in Claude, ChatGPT or Cursor, with a team.
Shared memory for AI tools: save once, recall word for word from Claude, ChatGPT, Codex or Gemini.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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.2MIT
- AlicenseAqualityBmaintenanceZero-config session continuity for Claude Code. Automatically captures and restores project context across sessions using Claude Hooks.25135 npm7MIT
- AlicenseNot gradedqualityCmaintenance2-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 PyPI430MIT
- AlicenseNot gradedqualityDmaintenancePersistent memory for Claude Code — a self-evolving knowledge layer that survives across sessions, grows from every conversation, and surfaces relevant context automatically.14MIT