Rekindle

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

npx rekindle init

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

Rekindle은 단순한 저장을 넘어 **세션 오리엔테이션(방향 설정)**을 해결하는 MCP 연속성 엔진입니다. 세션 시작 시 방향을 잡고, 세션 종료 시 내용을 캡처합니다. 모든 데이터는 로컬 SQLite에 저장되며, API 키가 필요 없습니다.

v0.2.0 — 오리엔테이션 도메인 계층, end_session 도구, 타입이 지정된 연속성 레코드. 릴리스 노트

빠른 시작

npx rekindle init을 실행하면 프로젝트 내에 SQLite 데이터베이스, ID 템플릿, 트랜스크립트 디렉토리가 포함된 .rekindle/ 폴더가 생성됩니다. 복사할 두 가지 블록이 출력됩니다:

1. MCP 설정 — ~/.claude.json에 붙여넣기 (Claude Code에 서버 위치를 알림)

2. 부팅 지침 — 프로젝트의 CLAUDE.md에 붙여넣기 (AI에게 방향 설정 방법을 알림)

그 후 .rekindle/identity.md를 작성하고 새로운 Claude Code 세션을 시작하세요.

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

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

43개의 세션을 분석한 결과, AI 어시스턴트가 세션 시작 시 로드하지 못한 항목은 다음과 같습니다:

기존 메모리 도구(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?)
  +-- Detect gaps (what am I missing?)
  +-- Calculate orientation score (how oriented am I?)
  --> "Carrying forward: [context loaded, gaps identified, score: 80/100]"

정상 출력:

## Orientation Score
100/100

+20  Identity document loaded
+20  Recent checkpoint exists
+20  Session transcript found
+20  Recent memories exist (last 7 days)
+10  Relationship/preference memories populated
+10  Project-scoped memories found

희소 출력 (누락된 항목 표시):

## Gaps Detected
- [critical] identity_missing: No identity document found
- [warning] checkpoint_missing: No recent checkpoint

## Orientation Score
20/100

 ✗  Identity document loaded (20pts)
 ✗  Recent checkpoint exists (20pts)
 ✗  Session transcript found (20pts)
+20  Recent memories exist (last 7 days)
 ✗  Relationship/preference memories populated (10pts)
 ✗  Project-scoped memories found (10pts)

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

end_session은 단순한 요약이 아닌 구조화된 연속성 레코드를 저장합니다:

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

세션 간 관리: 검색 및 관리

카테고리: preference lesson context relationship general

CLAUDE.md만으로는 부족한 이유

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

• 검색 — 중요도 가중치가 적용된 전체 텍스트 검색

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

• 오리엔테이션 — 요청 시 검색뿐만 아니라 부팅 시 선제적인 맥락 로드

• 누락 감지 — 누락된 ID, 빈 카테고리, 오래된 데이터 표시

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

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

v0.2.0 주요 변경 사항

• 7개의 MCP 도구 — 구조화된 세션 종료를 위한 end_session 추가

• 오리엔테이션 도메인 계층 — boot_report는 이제 얇은 래퍼이며, 모든 로직은 OrientationService, GapDetector, Scorer에 위치함

• 타입이 지정된 연속성 레코드 — 메모리는 내용 접두사 대신 type, source, session_id를 가짐

• 오리엔테이션 점수 산정 — 6개 기준에 걸친 100점 만점의 가산 체크리스트

• 구조화된 누락 정보 — 8개의 누락 코드가 포함된 { code, severity, message } 형식

• 64개의 자동화된 테스트 — 단위, 통합 및 성능 테스트

소스에서 설치

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

Claude Code를 위한 두 가지 선택적 Python 훅 (표준 라이브러리만 사용, 외부 의존성 없음):

extract-session.py (Stop 훅): 세션 종료 시 JSONL에서 Markdown 트랜스크립트를 추출합니다.

pre-compact-capture.py (PreCompact 훅): 맥락 압축 전 마지막 80개의 메시지를 저장합니다.

{
  "hooks": {
    "Stop": [{
      "type": "command",
      "command": "python3 /path/to/rekindle/hooks/extract-session.py"
    }]
  }
}

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

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

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

• 트랜스크립트 캡처는 선택 사항입니다. 훅은 기본적으로 설치되지 않습니다.

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

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

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

rekindle/
  src/
    index.ts          MCP server entry point
    server.ts         Server setup, tool registration
    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
    tools/
      boot-report.ts  Thin wrapper over OrientationService
      end-session.ts  Structured session close
      store.ts search.ts list.ts delete.ts update.ts
    init/
      cli.ts scaffold.ts templates/
  hooks/
    extract-session.py
    pre-compact-capture.py

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

전송: stdio (표준 MCP). Claude Code와 즉시 호환됩니다.

테스트

npm test

64개 테스트: 저장소 CRUD + FTS5 랭킹, 오리엔테이션 도메인(누락 감지, 점수 산정, 서비스, 렌더링), MCP 통합(7개 도구 전체), 성능(1000개 메모리 검색 100ms 미만).

로드맵

v0.3: "네트워크로 사고하기" — 확산 활성화, 임베딩을 통한 의미론적 검색, 부팅 보고서의 오픈 루프, 누락 분석 도구, 평가 하네스.

라이선스

MIT