# Rekindle > MCP session continuity engine. Boot reports, orientation scoring, and end-session capture. SQLite. - **Type:** MCP server - **Install:** `agentstack add mcp-skitchy-rekindle` - **Verified:** Pending review - **Seller:** [Skitchy](https://agentstack.voostack.com/s/skitchy) - **Installs:** 0 - **Latest version:** 0.2.1 - **License:** MIT - **Upstream author:** [Skitchy](https://github.com/Skitchy) - **Source:** https://github.com/Skitchy/rekindle - **Website:** https://www.npmjs.com/package/rekindle ## Install ```sh agentstack add mcp-skitchy-rekindle ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Rekindle [](https://www.npmjs.com/package/rekindle) [](#tests) [](LICENSE) [](https://glama.ai/mcp/servers/Skitchy/rekindle) **For Claude Code users who lose time re-explaining project context every session.** ```bash npx rekindle init ``` *Your AI forgets everything between sessions. Rekindle fixes that.* --- Rekindle is an MCP continuity engine that solves **session orientation**, not just storage. Orient at session start, capture at session end, survive mid-session compaction. All local, all SQLite, zero API keys. **v0.3.0 — "Survive the Long Middle"** — PreCompact capture system, open loops, review tracking. [Release notes](https://github.com/Skitchy/rekindle/releases/tag/v0.3.0) ## Quick Start ```bash npx rekindle init ``` This creates `.rekindle/` in your project with a SQLite database, identity template, captures directory, and transcript directory. Then add the MCP server config for your client: Claude Code Add to `~/.claude.json`: ```json { "mcpServers": { "rekindle": { "command": "npx", "args": ["-y", "rekindle"] } } } ``` Enable PreCompact protection (captures context before mid-session compaction): ```bash npx rekindle setup-hooks ``` Claude Desktop Add to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude\`): ```json { "mcpServers": { "rekindle": { "command": "npx", "args": ["-y", "rekindle"] } } } ``` Cursor Add to `.cursor/mcp.json` in your project root: ```json { "mcpServers": { "rekindle": { "command": "npx", "args": ["-y", "rekindle"] } } } ``` Then fill in `.rekindle/identity.md` and paste the boot instructions into your project's `CLAUDE.md`. > Session 1 stores. Session 2 remembers. Session 10 anticipates. --- ## The Problem (43 Sessions of Data) Over 43 sessions, we measured what an AI assistant failed to load at session start: | Metric | Value | |--------|-------| | Sessions analyzed | 43 | | Clean boots (all context loaded) | 33% | | High-signal failures (5+ gaps) | 26% | | Total retrieval failures | 173 | Existing memory tools (Mem0, Letta, Zep) optimize for retrieval accuracy: can the AI find what it stored? That's necessary but not sufficient. None of them address whether the AI loaded the *right* context for *this* session, or whether it can detect what it missed. Rekindle solves session orientation: loading identity, recent context, memory health, and missing-context warnings before the assistant starts work. See [docs/gap-analysis.md](docs/gap-analysis.md) for the full research dataset. --- ## What It Does ### Boot: orient at session start `boot_report` runs an orientation pipeline before any work begins: ``` 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]" ``` ### Survive the Long Middle: PreCompact capture (v0.3) Mid-session compaction destroys reasoning chains, failed approaches, relational texture, and tone. The PreCompact hook fires automatically before compaction and saves what would otherwise be lost: ``` 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 ``` Three read modes control token cost: - **summary** — one paragraph, cheap - **structured** — decisions/loops/warnings, moderate - **raw** — full transcript excerpt, expensive (only when needed) ### Capture: close the loop at session end `end_session` stores structured continuity records — not just a summary: | Field | What it captures | |-------|-----------------| | `checkpoint` | Where we left off (required) | | `decisions` | What was decided and why | | `open_loops` | Unresolved tasks or questions | | `constraints` | Boundaries that must not be violated | | `relational_delta` | What changed in the working relationship | | `next_session_focus` | Where to resume next session | | `preferences` | New user preferences learned | | `warnings` | Things next session should watch for | All records stored with `type`, `source`, and `session_id` metadata. Next `boot_report` loads the checkpoint automatically. ### Between sessions: search and manage | Tool | Description | |------|-------------| | `store_memory` | Store with content, category, importance (1-10), and project scope | | `search_memory` | Full-text search with BM25 ranking, boosted by importance | | `list_memories` | Browse memories, newest first. Filter by category or project | | `delete_memory` | Delete by ID | | `update_memory` | Update content, category, or importance | | `list_captures` | List PreCompact captures (optionally filter by session) | | `read_capture` | Read a capture in summary, structured, or raw mode | | `capture_now` | Manually capture current session context on demand | **Categories:** `preference` `lesson` `context` `relationship` `general` --- ## Why not just CLAUDE.md? A static file is passive. Your AI reads it, but it can't search it, rank it, track what's been retrieved, or tell you what's missing. Rekindle adds: - **Search** — full-text with importance-weighted ranking - **Structure** — category and project scoping across memories - **Orientation** — proactive context loading at boot, not just on-demand retrieval - **Gap detection** — flags missing identity, empty categories, stale data - **Scoring** — transparent checklist so you know *how oriented* the AI is - **Session capture** — structured close with checkpoints, decisions, and open loops - **Compaction survival** — PreCompact captures preserve what summaries flatten --- ## v0.3.0 Highlights - **10 MCP tools** — added `list_captures`, `read_capture`, `capture_now` - **PreCompact capture system** — automatic context preservation before mid-session compaction - **Open loops in boot_report** — surfaces unresolved tasks from prior sessions - **Review tracking** — captures marked reviewed after `read_capture`; `end_session` warns if unreviewed - **Hook setup** — `npx rekindle setup-hooks` configures Claude Code PreCompact hook - **Auto-discovery** — `capture_now` discovers session transcript without manual paths - **101 automated tests** — unit, integration, capture manager, hook setup --- ## CLI Commands | Command | Description | |---------|-------------| | `npx rekindle init` | Set up `.rekindle/` in current directory | | `npx rekindle init --global` | Set up in home directory | | `npx rekindle init --with-hooks` | Init + configure PreCompact hook | | `npx rekindle setup-hooks` | Configure PreCompact hook (standalone) | | `npx rekindle precompact-capture` | Capture context before compaction (hook) | | `npx rekindle capture-now` | Manually capture current session context | | `npx rekindle` | Start MCP server (used by Claude Code) | --- ## Install from Source ```bash git clone https://github.com/Skitchy/rekindle.git cd rekindle npm install npm run build node dist/init/cli.js init ``` PreCompact Hook Configuration The `setup-hooks` command writes this to `.claude/settings.local.json`: ```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 } ] } ] } } ``` The hook receives session context on stdin (session_id, transcript_path, cwd, hook_event_name) and writes captures to `.rekindle/captures/`. | Variable | Default | Description | |----------|---------|-------------| | `REKINDLE_PRECOMPACT_MAX_MESSAGES` | `80` | Max messages to capture | | `REKINDLE_PRECOMPACT_MAX_CHARS` | `120000` | Max characters to capture | | `REKINDLE_BASE_DIR` | Auto-detected | Base directory for `.rekindle/` | Privacy and Security - **All data is local.** Nothing is sent to external servers. - **No network calls.** The MCP server communicates via stdio. No HTTP, no telemetry, no analytics. - **Transcripts contain conversation text.** Do not enable transcript capture if your sessions contain secrets or credentials. - **Hook installation is opt-in.** `setup-hooks` must be run explicitly (not auto-installed by `init`). - **SQLite database is a regular file.** Not encrypted. Use OS-level disk encryption if needed. - **`.rekindle/` is gitignored.** The init command handles this automatically. - **boot_report reads local files.** Paths are not sandboxed. Only use with MCP clients and prompts you trust. ## Compatibility | Client | Transport | Status | |--------|-----------|--------| | Claude Code (macOS) | stdio | Tested | | Claude Code (Linux/WSL2) | stdio | Tested | | Claude Code (Windows) | stdio | Tested | | Claude Desktop | stdio | Compatible (same MCP config format) | | Cursor | stdio | Compatible (same MCP config format) | | Any MCP stdio client | stdio | Compatible | Architecture ``` 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/ ``` **Storage:** SQLite + FTS5 via `better-sqlite3`. BM25 ranking boosted by importance. Typed records with `type`, `source`, `session_id`. **Transport:** stdio (standard MCP). Works with Claude Code out of the box. ## Tests ```bash npm test ``` 101 tests: storage CRUD + FTS5 ranking, orientation domain (gap detection, scoring, service, rendering), capture manager (parsing, limits, review tracking, formatting), hook setup (schema, idempotency), and MCP integration (all 10 tools). ## Roadmap **v0.4: "It thinks in networks"** — Spreading activation, semantic search via embeddings, gap analysis tooling, eval harness. ## License MIT ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Skitchy](https://github.com/Skitchy) - **Source:** [Skitchy/rekindle](https://github.com/Skitchy/rekindle) - **License:** MIT - **Homepage:** https://www.npmjs.com/package/rekindle Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Versions - **0.2.1** — security scan: pending review — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-skitchy-rekindle - Seller: https://agentstack.voostack.com/s/skitchy - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.