passbaton

# passbaton > **Session continuity for AI coding agents.** Your agent picks up where it left off — never re-explain your project again. Persistent memory for **Claude Code, OpenAI Codex CLI & Google Gemini CLI**, sharing one local db: auto context injection, compaction handover, semantic search, and error→solution recall. Zero config, zero API cost, 100% local. [](https://www.npmjs.com/package/passbaton) [](https://www.npmjs.com/package/passbaton) [](https://opensource.org/licenses/MIT) **⚡ One install → context auto-loads every session · 🧩 survives compaction (0 re-explaining) · 🔒 100% local, $0 API**  > **Renamed (v2.0.0):** this project was previously `claude-session-continuity-mcp`. The old name suggested it was Claude-only — it never was. **Claude Code, Codex CLI, and Gemini CLI are all first-class and share one local memory.** Existing installs keep working: the old `claude-hook-*` commands still ship as aliases. See [Migrating from v1](#migrating-from-v1). ## The Problem Every new session — whether you're in Claude Code, Codex CLI, or Gemini CLI: ``` "This is a Next.js 15 project with App Router..." "We decided to use Server Actions because..." "Last time we were working on the auth system..." "The build command is pnpm build..." ``` **5 minutes of context-setting. Every. Single. Time.** ## The Solution **Fully automatic.** Lifecycle hooks handle everything without manual calls — on **Claude Code**, **OpenAI Codex CLI**, and **Google Gemini CLI**, sharing one local memory so context carries across all three: ```bash # Session start → Auto-loads relevant context + recent session history # When asking → Auto-injects relevant memories/solutions # During conversation → Tracks active files + auto-injects error solutions # On compact → Structured handover context for continuity # On exit → Extracts commits, decisions, error-fix pairs from transcript ``` ``` ← Auto-output on session start: # my-app - Session Resumed 📍 **State**: Implementing signup form ## Recent Sessions ### 2026-02-28 **Work**: Completed OAuth integration with Google provider **Commits**: feat: add OAuth callback handler; fix: redirect URI config **Decisions**: Use Server Actions instead of API routes ### 2026-02-27 **Work**: Set up authentication foundation **Next**: Implement signup form validation ## Directives - 🔴 Always use Zod for form validation - 📎 Prefer Server Components by default ## Key Memories - 🎯 Decided on App Router, using Server Actions - ⚠️ OAuth redirect_uri mismatch → check env file ``` **Zero manual work. Context follows you.** --- ## Why this over other memory tools? Most Claude memory tools rely on **explicit tool calls** ("remember this"), a **cloud API**, or a **background AI worker**. This one is deliberately different: | | passbaton | Typical cloud/AI-memory MCP | |---|---|---| | **Setup** | `npm i -g` → hooks auto-install | Manual server + API key | | **Trigger** | 5 automatic hooks (no commands) | You call a `remember` tool | | **Storage** | 100% local SQLite | Cloud / external service | | **API cost** | **$0** — local embeddings | Per-token / subscription | | **Latency** | < 5ms (on-device) | Network round-trip | | **Privacy** | Never leaves your machine | Sent to a provider | | **Search** | FTS5 + local semantic, KO/EN/JA cross-lingual | Varies | If you want zero-config, offline, no-cost memory that just *happens* while you work — this is it. ### Auto-injection vs. explicit search There's also a great class of **local search** tools (e.g. [ctx](https://github.com/ctxrs/ctx)) that index your agent history so you can *query* it (`search "failed migration"`). That's complementary, not the same job: | | passbaton | Local-search tools (ctx, etc.) | |---|---|---| | **How you use it** | **Automatic** — context appears on session start, no command | You (or the agent) run a search query | | **Compaction** | **PreCompact hook re-injects a handover** → 0 context re-explained after a compact | Not its job (it's a search index) | | **Best at** | *Never losing your thread* across sessions & compacts, hands-off | *Finding* a specific past decision/command on demand | | **Coverage** | Claude Code + Codex CLI + Gemini CLI (where auto-injection is possible) | Often 30+ agents indexed for search | Use search when you want to *look something up*. Use this when you want your context to *follow you* without asking. --- ## Codex CLI support (v1.16.0+) Beyond Claude Code, this also supports **OpenAI Codex CLI**. If `~/.codex` exists, the installer registers the same hooks in `~/.codex/hooks.json` (SessionStart, UserPromptSubmit, PreCompact, Stop), and the hooks auto-detect the host and emit the right output format (Codex's `hookSpecificOutput.additionalContext`). The same local `sessions.db` is shared, so context carries across both agents: what you did in Codex is available in Claude Code and vice versa. **Scope:** session save + context injection work on both. Codex file-change tracking (PostToolUse) isn't wired yet — session save already covers most of it via transcript parsing. Codex's `transcript_path` is treated as an unstable interface (it can be null at startup), so host detection uses an installer-injected `--codex` marker rather than relying on the path. --- ## Gemini CLI support (v1.17.0+) Also supports **Google Gemini CLI**. If `~/.gemini` exists, the installer registers the hooks in `~/.gemini/settings.json` (SessionStart, BeforeAgent, PreCompress, SessionEnd — Gemini's event names), preserving your other settings. Same shared local `sessions.db`, so context carries across all three agents. Gemini's transcript format was verified against real `~/.gemini/tmp/.../chats/*.jsonl` files — it uses **two shapes** (a flat `{type, content}` line and an older `{"$set":{"messages":[…]}}` diff line); the parser handles both. Like Codex, `transcript_path` can be null at startup, so host detection uses a `--gemini` marker. **Honest scope note:** session save (SessionEnd) and context output are verified working. Gemini's `SessionStart` context injection is documented as *advisory-only* upstream ([gemini-cli#15413](https://github.com/google-gemini/gemini-cli/issues/15413)) — if your Gemini build doesn't render the injected context on startup, that's an upstream limit, not this tool. Session continuity still works via the saved history. --- ## Migrating from v1 If you installed this as `claude-session-continuity-mcp` (v1.x), **nothing breaks** — the v1 `claude-hook-*` commands still ship as aliases in v2. To move to the new name: ```bash npm install -g passbaton # installs the new package npm uninstall -g claude-session-continuity-mcp # optional: drop the old one ``` The installer rewrites your hook entries to `passbaton-hook-*` and removes the old `claude-hook-*` lines — it matches on both names, so you won't end up with duplicates. Your existing `sessions.db` is untouched: **all past sessions, memories, and solutions carry over.** Nothing else changes — same hooks, same database, same behavior. --- ## Quick Start > **Requires Node.js 22+.** The native `better-sqlite3` dependency only ships > prebuilt binaries for Node 22, 24, and 26 (the currently supported lines — > Node 18 and 20 are both end-of-life). On older Node it falls back to compiling > from source, which fails without build tools. Node 22 and up install cleanly > with no compiler needed. ### Recommended: Global Installation ```bash npm install -g passbaton ``` **That's it!** The postinstall script automatically: 1. Registers MCP server in `~/.claude.json` 2. Installs Claude Hooks in `~/.claude/settings.json` ### Why Global (`-g`)? This tool is designed to track **all your Claude Code projects** in a single unified database. Global installation is strongly recommended because: | Reason | Detail | |---|---| | **Single source of truth** | One binary serves every project — no version drift between projects | | **Hooks are user-scoped** | `~/.claude/settings.json` lives in your home directory, not per-project | | **Cross-project context** | Sessions from `app-a` and `app-b` share the same DB and search index | | **One update = everything refreshed** | `npm install -g <latest>` updates all projects at once; no per-project reinstall | | **`npm exec` resolves global first** | Hooks call `npm exec -- passbaton-hook-*` which finds the global package reliably regardless of cwd | **Important**: Even with global install, you can still **disable the hook for specific projects** (see below). Global ≠ forced on every project. ### Disabling Hooks for Specific Projects Global install does **not** mean "always on everywhere". You have three layers of control: | Layer | File | Scope | |---|---|---| | 1. Global ON (default) | `~/.claude/settings.json` | All projects | | 2. Project-wide OFF | `<project>/.claude/settings.json` | Whole team (committed) | | 3. Personal-only OFF | `<project>/.claude/settings.local.json` | Just you (gitignored) | **To disable hooks in a specific project**, create the override file with empty hook arrays: ```json // <project>/.claude/settings.json (or settings.local.json for personal-only) { "hooks": { "SessionStart": [], "UserPromptSubmit": [], "PostToolUse": [], "PreCompact": [], "Stop": [] } } ``` Empty arrays override the global setting → that project's sessions are no longer tracked. ### Updating to a New Version ```bash npm install -g passbaton@latest ``` That's the only step — all projects pick up the new binary on next Claude Code restart. No need to reinstall in each project. ### Alternative: Local Install (Not Recommended) If you really want per-project install (e.g., locked version for one project): ```bash cd <project> && npm install passbaton ``` Drawback: you must install separately in every project, and `npm exec` may not find the local copy reliably from hook context (cwd-dependent). Stick with `-g` unless you have a specific reason. ### What Gets Installed **MCP Server** (in `~/.claude.json`): ```json { "mcpServers": { "project-manager": { "command": "npx", "args": ["passbaton"] } } } ``` **Claude Hooks** (in `~/.claude/settings.json`): ```json { "hooks": { "SessionStart": [{ "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-session-start" }] }], "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-user-prompt" }] }], "PostToolUse": [{ "matcher": "Edit", "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-post-tool" }] }, { "matcher": "Write", "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-post-tool" }] }], "PreCompact": [{ "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-pre-compact" }] }], "Stop": [{ "hooks": [{ "type": "command", "command": "npm exec -- passbaton-hook-session-end" }] }] } } ``` **Note (v1.5.0+):** Full lifecycle coverage with 5 hooks. Uses `npm exec --` which finds local `node_modules/.bin` first. ### Installed Hooks (v1.5.0+) | Hook | Command | Function | |------|---------|----------| | `SessionStart` | `passbaton-hook-session-start` | Auto-loads project context on session start | | `UserPromptSubmit` | `passbaton-hook-user-prompt` | Auto-injects relevant memories + past reference search | | `PostToolUse` | `passbaton-hook-post-tool` | Tracks active files (Edit, Write) + auto-injects error solutions (Bash) | | `PreCompact` | `passbaton-hook-pre-compact` | Structured handover context before compression | | `Stop` | `passbaton-hook-session-end` | Extracts commits, decisions, error-fix pairs from transcript | ### Manual Hook Management ```bash # Check hook status npx passbaton-hooks status # Reinstall hooks npx passbaton-hooks install # Remove hooks npx passbaton-hooks uninstall ``` ### 3. Restart Claude Code After installation, restart Claude Code to activate the hooks. --- ## Features | Feature | Description | |---------|-------------| | 🤖 **Zero Manual Work** | Claude Hooks automate all context capture/load | | 🎯 **Quality Memory Only** | **(v1.10.0)** Only decisions, learnings, errors — no file-change noise | | 🧠 **Semantic Search** | multilingual-e5-small embedding (94+ languages, 384d) | | 🌍 **Multilingual** | Korean/English/Japanese + cross-language search (EN→KR, KR→EN) | | 🔗 **Git Integration** | Commit messages auto-extracted from transcripts | | 🕸️ **Knowledge Graph** | Memory relations (solves, causes, extends...) | | 📊 **Memory Classification** | 5 types: observation, decision, learning, error, pattern | | ✅ **Integrated Verification** | One-click build/test/lint execution | | 📋 **Task Management** | Priority-based task management | | 🔧 **Auto Error→Solution** | **(v1.12.0)** Bash errors auto-detect → inject past solutions; session-end auto-records error-fix pairs | | 💰 **Token Efficiency** | **(v1.11.0)** Removed loadContext from UserPromptSubmit (saves 24-60K tokens/session) | | 📑 **Progressive Disclosure** | **(v1.11.0)** memory_search returns index first, memory_get for full content | | ⏳ **Temporal Decay** | **(v1.11.0)** Memory scoring with type-specific half-lives for relevance | | 📝 **Structured Handover** | **(v1.10.0)** PreCompact saves work summary, active files, pending actions | | 🚪 **Smart Session End** | **(v1.10.0)** Extracts commits, decisions, error-fix pairs from transcript | | 🗑️ **Auto Noise Cleanup** | **(v1.10.0)** Auto-deletes stale observation memories (3d+) | | 🔍 **Past Reference Detection** | **(v1.8.0)** "저번에 X 어떻게 했어?" auto-searches DB | | 📝 **User Directive Extraction** | **(v1.8.0)** Auto-extracts "always/never" rules from prompts | --- ## Feature toggles — everything is opt-in **(v2.1.0)** Every feature can be turned on/off individually. Config lives in a plain, hand-editable JSON file (`~/.claude/passbaton.config.json`) — separate from your data, so it survives a db reset. No file = today's defaults (nothing changes for existing users). ```bash passbaton config # print a grouped table of every feature + on/off passbaton config set patternMining on # flip one feature passbaton config preset minimal # minimal | default | everything passbaton config reset # back to defaults passbaton config path # print the active config file path ``` Each feature also has an env override for one-off/CI use: `PASSBATON_<FEATURE>=0` (e.g. `PASSBATON_TRIGGERMATCHING=0`) wins over the config file. **On-by-default rule:** a feature ships **on** only if it's *silent, safe, and universally useful*. Anything that speaks unprompted, guesses, or writes speculative rows ships **off**. ### Core (on by default) | Feature | Key | What it does | |---|---|---| | Session start injection | `sessionStart` | Restore prior context on start | | **Compaction handover+** | `compactionHandover` | Before a compaction, carry over your working state **plus hot files and last build status** — the one gap platform auto-memory structurally can't cover | | Session persist | `sessionEnd` | Save session state on exit | | Auto memory surfacing | `autoInject` | Auto-surface relevant past memories on start | | Task tracking | `taskTracking` | Read/write the task list via MCP + hooks | | **Hot-path pre-warm** | `hotPathPrewarm` | On start, surface the files you edit most in this project, ranked by real access count | | **Verification ledger** | `verificationLedger` | Warn on start if a recent session left the build red or issues open | ### Cross-agent (on by default) | Feature | Key | What it does | |---|---|---| | Cross-agent share | `crossAgentSync` | One local db shared across Claude Code / Codex / Gemini | | Tool-use capture | `postToolCapture` | Observe tool use to build hot-paths (low-noise) | ### Experimental (off by default — opt in) | Feature | Key | What it does | |---|---|---| | Trigger matching | `triggerMatching` | Match prompt keywords to auto-inject solutions (can false-positive) | | Pattern mining | `patternMining` | Mine work patterns and suggest workflows (opinionated) | | Memory auto-store | `memoryAutoStore` | Auto-write observation memories from prompts (noisy) | | Status line | `statusLineInject` | Append a passbaton status line to session-start output | --- ## Claude Hooks - Auto Context System ### How It Works **SessionStart Hook** (`npx passbaton-hook-session-start`): - Auto-detects project: monorepo (`apps/project-name/`) or single project (`package.json` root folder name) - Loads context from `.claude/sessions.db` - Injects: Current state, **3 recent sessions** with commits/decisions, directives, pending tasks, filtered key memories - Auto-cleans stale noise memories (3d+ auto-tracked, 14d+ auto-compact) **UserPromptSubmit Hook** (`npx passbaton-hook-user-prompt`): - Runs on every prompt submission - **(v1.11.0)** No longer calls loadContext() — saves 24-60K tokens/session - Injects relevant context (filtered: decisions, learnings, errors only) **PostToolUse Hook** (`npx passbaton-hook-post-tool`): - Tracks hot file paths and updates `active_context.recent_files` - **(v1.12.0)** Auto-detects Bash errors → searches solutions DB → injects past solutions into context - **No longer creates observation memories** (v1.10.0 — eliminates `[File Change]` noise) **PreCompact Hook** (`npx passbaton-hook-pre-compact`): - Builds structured handover context: work summary, active file, pending action, key facts, recent errors - **No longer stores auto-compact memories** (v1.10.0) **Stop Hook** (`npx passbaton-hook-session-end`): - Extracts commit messages from JSONL transcript (`git commit -m` patterns) - Extracts error-fix pairs (error → resolution within 3 messages) - **(v1.12.0)** Auto-records error→fix pairs to solutions table for future reuse - Extracts decisions ("because", "instead of", "chose" patterns) - **(v1.11.0)** Single-pass transcript parsing (4 JSONL reads → 1) - Stores structured metadata in `sessions.issues` column as JSON ### Example Output (Session Start) ```markdown # my-app - Session Resumed 📍 **State**: Implementing signup form 🚧 **Blocker**: OAuth callback URL issue ## Recent Sessions ### 2026-02-28 **Work**: Completed OAuth integration **Commits**: feat: add OAuth handler; fix: redirect config **Decisions**: Use Server Actions over API routes **Next**: Implement form validation ## Directives - 🔴 Always use Zod for validation ## Pending Tasks - 🔄 [P8] Implement form validation - ⏳ [P5] Add error handling ## Key Memories - 🎯 Decided on App Router, using Server Actions - ⚠️ OAuth redirect_uri mismatch → check env file ``` ### Hook Management ```bash # Check status npx passbaton-hooks status # Reinstall npx passbaton-hooks install # Remove npx passbaton-hooks uninstall # Temporarily disable export MCP_HOOKS_DISABLED=true ``` ### Past Reference Detection (v1.8.0) When you ask about past work, the `UserPromptSubmit` hook automatically searches the database: ``` You: "저번에 인앱결제 어떻게 했어?" → Hook detects "저번에" + extracts keyword "인앱결제" → Searches sessions, memories (FTS5), and solutions → Injects matching results into context automatically ``` **Supported patterns (Korean & English):** | Pattern | Example | |---------|---------| | 저번에/전에/이전에 ... 어떻게 | "저번에 CORS 에러 어떻게 해결했지?" | | ~했던/만들었던/해결했던 | "수정했던 로그인 로직" | | 지난 세션/작업에서 | "지난 세션에서 결제 구현" | | last time/before/previously | "How did we handle auth last time?" | | did we/did I ... before | "Did we fix the database migration before?" | | remember when/recall when | "Remember when we set up CI?" | **Output example:** ```markdown ## Related Past Work (auto-detected from your question) ### Sessions - [2/14] 카카오 로그인 앱키 수정, 인앱결제 IAP 플로우 수정 ### Memories - 🎯 [decision] 테스트: 인앱결제 상품 등록 완료 ### Solutions - **IAP_BILLING_ERROR**: StoreKit 2 migration으로 해결 ``` ### Why npm exec? (v1.4.3+) Previous versions used absolute paths or `npx`: ```json // v1.3.x - absolute paths (broke on multi-project) "command": "node \"/path/to/project-a/node_modules/.../session-start.js\"" // v1.4.0-1.4.2 - npx (required global install or hit npm registry) "command": "npx passbaton-hook-session-start" ``` Now we use `npm exec --`: ```json "command": "npm exec -- passbaton-hook-session-start" ``` **`npm exec --` finds local `node_modules/.bin` first**, then falls back to global. Works with both local and global installation without hitting npm registry. --- ## Tools (v5 API) - 25 Focused Tools ### 1. Session Lifecycle (4) ⭐ ```javascript // Start of session - auto-loads context session_start({ project: "my-app", compact: true }) // End of session - auto-saves context session_end({ project: "my-app", summary: "Completed auth flow", modifiedFiles: ["src/auth.ts", "src/login/page.tsx"] }) // View session history session_history({ project: "my-app", limit: 5 }) // Semantic search past sessions search_sessions({ query: "auth work", project: "my-app" }) ``` ### 2. Project Management (4) ```javascript // Get project status with task stats project_status({ project: "my-app" }) // Initialize new project project_init({ project: "my-app" }) // Analyze project tech stack project_analyze({ project: "my-app" }) // List all projects list_projects() ``` ### 3. Task Management (4) ```javascript // Add a task task_add({ project: "my-app", title: "Implement signup", priority: 8 }) // Update task status task_update({ taskId: 1, status: "done" }) // List tasks task_list({ project: "my-app", status: "pending" }) // Suggest tasks from TODO comments task_suggest({ project: "my-app" }) ``` ### 4. Solution Archive (3) ```javascript // Record an error solution solution_record({ errorSignature: "TypeError: Cannot read property 'id'", solution: "Use optional chaining: user?.id" }) // Find similar solutions (keyword or semantic) solution_find({ query: "TypeError property", semantic: true }) // AI-powered solution suggestion solution_suggest({ errorMessage: "Cannot read property 'email'" }) ``` ### 5. Verification (3) ```javascript // Run build verify_build({ project: "my-app" }) // Run tests verify_test({ project: "my-app" }) // Run all (build + test + lint) verify_all({ project: "my-app" }) ``` ### 6. Memory System (5) ```javascript // Store a classified memory memory_store({ content: "State management with Riverpod makes testing easier", type: "learning", // observation, decision, learning, error, pattern project: "my-app", tags: ["flutter", "state-management"], importance: 8, relatedTo: 23 // Connect to existing memory }) // Search memories — returns index (id, type, tags, score) for token efficiency memory_search({ query: "state management test", type: "learning", semantic: true, // Use embedding similarity limit: 10 }) // Get full memory content by ID (v1.11.0) memory_get({ memoryId: 23 }) // Find related memories (graph + semantic) memory_related({ memoryId: 23, includeGraph: true, includeSemantic: true }) // Get memory statistics memory_stats({ project: "my-app" }) ``` ### 7. Knowledge Graph (2) ```javascript // Connect two memories with a typed relation graph_connect({ sourceId: 23, targetId: 25, relation: "solves", // related_to, causes, solves, depends_on, contradicts, extends, example_of strength: 0.9 }) // Explore knowledge graph graph_explore({ memoryId: 23, depth: 2, relation: "all", // or specific relation type direction: "both" // outgoing, incoming, both }) ``` ## Memory Types | Type | Description | Use Case | |------|-------------|----------| | `observation` | Patterns, structures found in codebase | "All screens are separated in features/ folder" | | `decision` | Architecture, library choices | "Decided to use SharedPreferences for caching" | | `learning` | New knowledge, best practices | "Riverpod is better for testing" | | `error` | Occurred errors and solutions | "Provider.read() doesn't rebuild → use watch()" | | `pattern` | Recurring code patterns, conventions | "Avoid late keyword abuse" | ## Relation Types | Relation | Description | Example | |----------|-------------|---------| | `related_to` | General relation | A and B are related | | `causes` | A causes B | Caching decision → folder structure change | | `solves` | A solves B | Riverpod learning → Provider bug fix | | `depends_on` | A depends on B | Folder structure → Caching decision | | `contradicts` | A conflicts with B | Two design decisions conflict | | `extends` | A extends B | late pattern → Extended to Riverpod learning | | `example_of` | A is example of B | Specific code is example of pattern | --- ## Data Storage SQLite database at `~/.claude/sessions.db`: | Table | Purpose | |-------|---------| | `memories` | Classified memories (observation, decision, learning, error, pattern) | | `memories_fts` | Full-text search index (FTS5) | | `memory_relations` | Knowledge graph relations | | `embeddings_v4` | Semantic search vectors (multilingual-e5-small, 384d) | | `project_context` | Fixed project info (tech stack, decisions) | | `active_context` | Current work state | | `tasks` | Task backlog | | `solutions` | Error solution archive | | `sessions` | Session history | --- ## Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `WORKSPACE_ROOT` | - | Workspace root path (required) | | `MCP_HOOKS_DISABLED` | `false` | Disable Claude Hooks | | `LOG_LEVEL` | `info` | Log level (debug/info/warn/error) | | `LOG_FILE` | - | Optional file logging path | --- ## Development ```bash # Clone git clone https://github.com/leesgit/passbaton.git cd passbaton # Install npm install # Build npm run build # Test npm test # Test with coverage npm run test:coverage ``` --- ## Performance | Metric | Value | |--------|-------| | Context load (cached) | **<5ms** | | Memory search (FTS) | ~10ms | | Semantic search | ~50ms | | Build verification | Project-dependent | --- ## Roadmap - [x] v2 API (15 focused tools) - [x] v4 API (24 tools - memory + graph) - [x] v5 Claude Hooks (auto-capture) - [x] Knowledge Graph with typed relations - [x] Memory classification (6 types) - [x] Semantic search (embeddings) - [x] Multilingual pattern detection (KO/EN/JA) - [x] Git commit integration - [x] 111 tests (6 test suites) - [x] GitHub Actions CI/CD - [x] Multilingual semantic search (v1.6.0 - multilingual-e5-small) - [x] Cross-language search EN↔KR (v1.6.0) - [x] Solution semantic search (v1.6.0) - [x] Fix hooks settings file path (v1.6.1 - settings.json, not settings.local.json) - [x] Auto-migrate legacy hooks (v1.6.1) - [x] Fix PostToolUse matcher format to string (v1.6.3) - [x] Fix README documentation for new hook format (v1.6.4) - [x] Empty session skip and techStack save improvements (v1.7.1) - [x] Past reference auto-detection in UserPromptSubmit hook (v1.8.0) - [x] User directive extraction ("always/never" rules) (v1.8.0) - [x] Memory quality overhaul — no more `[File Change]` noise (v1.10.0) - [x] Structured handover context in PreCompact (v1.10.0) - [x] Smart session-end: commit/decision/error-fix extraction from transcript (v1.10.0) - [x] Auto noise cleanup (3d+ observations, 14d+ auto-compact) (v1.10.0) - [x] 3 recent sessions display with structured metadata (v1.10.0) - [x] Token efficiency — remove loadContext from UserPromptSubmit, saves 24-60K tokens/session (v1.11.0) - [x] Single-pass transcript parsing, 4 JSONL reads → 1 (v1.11.0) - [x] Temporal decay for memory scoring with type-specific half-lives (v1.11.0) - [x] Progressive disclosure — memory_search returns index, memory_get for full content (v1.11.0) - [x] Memory consolidation via Jaccard similarity (v1.11.0) - [x] Auto error→solution pipeline — PostToolUse detects Bash errors, injects past solutions (v1.12.0) - [x] SessionEnd auto-records error-fix pairs to solutions table (v1.12.0) - [x] Cross-project solution search with current project prioritization (v1.12.0) - [ ] sqlite-vec native vector search (v2 - when data > 1000 records) - [ ] Web dashboard - [ ] Cloud sync option --- ## Contributing PRs welcome! Please: 1. Fork the repo 2. Create a feature branch 3. Add tests for new features 4. Ensure `npm test` passes 5. Submit PR --- ## License [MIT](LICENSE) © Byeongchang Lee --- ## Acknowledgments - [Model Context Protocol](https://modelcontextprotocol.io/) by Anthropic - [Xenova Transformers](https://github.com/xenova/transformers.js) for embeddings --- <div align="center"> **If this saves you from re-explaining your project, consider giving it a ⭐ — it genuinely helps others find it.** </div>