claude-session-continuity-mcp

Alternative: Local Install (Not Recommended)

If you really want per-project install (e.g., locked version for one project):

cd <project> && npm install passbaton

Drawback: you must install separately in every project, andnpm execmay not find the local copy reliably from hook context (cwd-dependent). Stick with-gunless you have a specific reason.

{ "mcpServers": { "project-manager": { "command": "npx", "args": ["passbaton"] } } }

Claude Hooks(in~/.claude/settings.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. Usesnpm exec --which finds localnode_modules/.binfirst.

# Check hook status npx passbaton-hooks status # Reinstall hooks npx passbaton-hooks install # Remove hooks npx passbaton-hooks uninstall

After installation, restart Claude Code to activate the hooks.

(v2.1.0+)Five behaviours are individually toggleable; the rest are shown for transparency but arealways on(a hook's mere existence is controlled by yoursettings.json, not by config) ornot yet wired. 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).

passbaton config # grouped table; ●/○ = toggleable, · = always on passbaton config set solutionCapture off # flip a toggleable feature passbaton config set strictSolutionGate on # opt into the strict error→fix filter passbaton config preset minimal # minimal | default | everything passbaton config reset # back to defaults passbaton config path # print the active config file path

Trying tosetan always-on / not-yet-wired feature is rejected with a clear message. Each toggleable feature also has an env override for one-off/CI use:PASSBATON_<FEATURE>=0(e.g.PASSBATON_SOLUTIONCAPTURE=0) wins over the config file.

On-by-default rule:a feature shipsononly if it'ssilent, safe, and universally useful. Anything that speaks unprompted, guesses, or writes speculative rows shipsoff.

Legend:●/○= toggleable (on/off) ··= always on, not a config toggle ·⋯= not yet wired.

sessionStart/sessionEndare "always on" because a hook either runs or it doesn't — that's controlled by the hook registration in~/.claude/settings.json, not by config. To disable them, remove the hook there.

The only genuinely user-flippable flags today arecompactionHandover,hotPathPrewarm,verificationLedger,solutionCapture(on) andstrictSolutionGate(opt-in).

SessionStart Hook(npx passbaton-hook-session-start):

- Auto-detects project: monorepo (apps/project-name/) or single project (package.jsonroot folder name)
- Loads context from.claude/sessions.db
- Injects: Current state,3 recent sessionswith 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 updatesactive_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 -mpatterns)
- 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 insessions.issuescolumn as JSON

# 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

# Check status npx passbaton-hooks status # Reinstall npx passbaton-hooks install # Remove npx passbaton-hooks uninstall # Temporarily disable export MCP_HOOKS_DISABLED=true

When you ask about past work, theUserPromptSubmithook 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):

## Related Past Work (auto-detected from your question) ### Sessions - [2/14] 카카오 로그인 앱키 수정, 인앱결제 IAP 플로우 수정 ### Memories - 🎯 [decision] 테스트: 인앱결제 상품 등록 완료 ### Solutions - IAP_BILLING_ERROR: StoreKit 2 migration으로 해결

Previous versions used absolute paths ornpx:

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

"command": "npm exec -- passbaton-hook-session-start"

npm exec --finds localnode_modules/.binfirst, then falls back to global. Works with both local and global installation without hitting npm registry.

// 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" })

// 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()

// 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" })

// 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'" })

// Run build verify_build({ project: "my-app" }) // Run tests verify_test({ project: "my-app" }) // Run all (build + test + lint) verify_all({ project: "my-app" })

// 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" })

// 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 })

SQLite database at~/.claude/sessions.db: