claude-session-continuity-mcp 1.17.0 → 1.17.2

package/README.md

@@ -1,6 +1,6 @@
 # claude-session-continuity-mcp
 
-> **Never re-explain your project to your AI coding agent again.** 100% local session memory for **Claude Code & OpenAI Codex CLI** — auto context injection, semantic search, and error→solution recall. Zero config, zero API cost.
+> **Never re-explain your project to your AI coding agent again.** 100% local session memory for **Claude Code, OpenAI Codex CLI & Google Gemini CLI** — auto context injection, semantic search, and error→solution recall. Zero config, zero API cost.
 
 [![npm version](https://img.shields.io/npm/v/claude-session-continuity-mcp.svg)](https://www.npmjs.com/package/claude-session-continuity-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/claude-session-continuity-mcp.svg)](https://www.npmjs.com/package/claude-session-continuity-mcp)
@@ -11,9 +11,11 @@
 
 ![Session continuity demo — Claude auto-restores your project context on session start](assets/demo.gif)
 
+> **Name note:** the package is called `claude-session-continuity-mcp` for historical reasons, but it is **agent-agnostic** — Claude Code, Codex CLI, and Gemini CLI are first-class and share one local memory.
+
 ## The Problem
 
-Every new Claude Code session:
+Every new session — whether you're in Claude Code, Codex CLI, or Gemini CLI:
 
 ```
 "This is a Next.js 15 project with App Router..."
@@ -26,7 +28,7 @@ Every new Claude Code session:
 
 ## The Solution
 
-**Fully automatic.** Lifecycle hooks handle everything without manual calls — on **Claude Code** and **OpenAI Codex CLI**, sharing one local memory so context carries across both:
+**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
@@ -90,13 +92,13 @@ There's also a great class of **local search** tools (e.g. [ctx](https://github.
 | **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 (where auto-injection is possible) | Often 30+ agents indexed for search |
+| **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.
 
 ---
 
-## Works with Codex CLI too (v1.16.0+)
+## 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,
@@ -114,7 +116,7 @@ interface (it can be null at startup), so host detection uses an installer-injec
 
 ---
 
-## Works with Gemini CLI too (v1.17.0+)
+## 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,
@@ -136,6 +138,12 @@ not this tool. Session continuity still works via the saved history.
 
 ## 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

package/dist/index.js

@@ -20,7 +20,8 @@ import { ListToolsRequestSchema, CallToolRequestSchema, ListPromptsRequestSchema
 import * as fs from 'fs/promises';
 import { mkdirSync, existsSync } from 'fs';
 import * as path from 'path';
-import { execSync } from 'child_process';
+import { execSync, spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
 import Database from 'better-sqlite3';
 import { tokenizeQuery, buildFtsQuery } from './utils/tokenize.js';
 // @xenova/transformers - 동적 import (sharp 의존성 문제 방지)
@@ -2173,4 +2174,25 @@ async function main() {
     await server.connect(transport);
     console.error('Project Manager MCP v5 started (24 tools + 3 prompts for auto-injection)');
 }
-main().catch(console.error);
+// CLI subcommands (install/uninstall/status/help) → delegate to the hooks installer.
+// Without this, `npx claude-session-continuity-mcp install` runs the default bin
+// (the MCP server), which ignores the arg and hangs on stdio — looks broken to users.
+const CLI_COMMANDS = new Set(['install', 'uninstall', 'remove', 'status']);
+const cliArg = process.argv[2];
+if (cliArg && (CLI_COMMANDS.has(cliArg) || cliArg === 'help' || cliArg === '--help' || cliArg === '-h')) {
+    if (cliArg === 'help' || cliArg === '--help' || cliArg === '-h') {
+        console.log('Usage: npx claude-session-continuity-mcp [install|uninstall|status]');
+        console.log('  install    Register lifecycle hooks for Claude Code / Codex CLI / Gemini CLI');
+        console.log('  uninstall  Remove the hooks');
+        console.log('  status     Show installed hooks');
+        console.log('  (no arg)   Start the MCP server (stdio) — used by the hook runtime');
+        process.exit(0);
+    }
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const installerPath = path.join(here, 'hooks', 'install.js');
+    const result = spawnSync(process.execPath, [installerPath, cliArg], { stdio: 'inherit' });
+    process.exit(result.status ?? 0);
+}
+else {
+    main().catch(console.error);
+}

package/dist/schemas.d.ts

@@ -21,15 +21,15 @@ export declare const ContextUpdateSchema: z.ZodObject<{
     project: string;
     currentState: string;
     verification?: "passed" | "failed" | undefined;
-    recentFiles?: string[] | undefined;
     blockers?: string | undefined;
+    recentFiles?: string[] | undefined;
     architectureDecision?: string | undefined;
 }, {
     project: string;
     currentState: string;
     verification?: "passed" | "failed" | undefined;
-    recentFiles?: string[] | undefined;
     blockers?: string | undefined;
+    recentFiles?: string[] | undefined;
     architectureDecision?: string | undefined;
 }>;
 export declare const MemoryStoreSchema: z.ZodObject<{
@@ -40,15 +40,15 @@ export declare const MemoryStoreSchema: z.ZodObject<{
     importance: z.ZodDefault<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    type: "error" | "observation" | "decision" | "learning" | "pattern" | "preference";
     content: string;
+    type: "pattern" | "observation" | "decision" | "learning" | "error" | "preference";
     importance: number;
     project?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
-    type: "error" | "observation" | "decision" | "learning" | "pattern" | "preference";
     content: string;
+    type: "pattern" | "observation" | "decision" | "learning" | "error" | "preference";
     project?: string | undefined;
     tags?: string[] | undefined;
     importance?: number | undefined;
@@ -63,20 +63,20 @@ export declare const MemorySearchSchema: z.ZodObject<{
     minImportance: z.ZodDefault<z.ZodNumber>;
     detail: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    limit: number;
     query: string;
-    minImportance: number;
+    limit: number;
     semantic: boolean;
+    minImportance: number;
     detail: boolean;
     project?: string | undefined;
-    type?: "error" | "observation" | "decision" | "learning" | "pattern" | "preference" | undefined;
+    type?: "pattern" | "observation" | "decision" | "learning" | "error" | "preference" | undefined;
 }, {
     query: string;
     project?: string | undefined;
-    type?: "error" | "observation" | "decision" | "learning" | "pattern" | "preference" | undefined;
     limit?: number | undefined;
-    minImportance?: number | undefined;
     semantic?: boolean | undefined;
+    type?: "pattern" | "observation" | "decision" | "learning" | "error" | "preference" | undefined;
+    minImportance?: number | undefined;
     detail?: boolean | undefined;
 }>;
 export declare const MemoryGetSchema: z.ZodObject<{
@@ -103,30 +103,30 @@ export declare const TaskManageSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<["pending", "in_progress", "done", "blocked"]>>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    action: "update" | "list" | "add" | "complete";
-    title?: string | undefined;
-    status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
+    action: "update" | "add" | "list" | "complete";
     description?: string | undefined;
+    title?: string | undefined;
     taskId?: number | undefined;
     priority?: number | undefined;
+    status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
 }, {
     project: string;
-    action: "update" | "list" | "add" | "complete";
-    title?: string | undefined;
-    status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
+    action: "update" | "add" | "list" | "complete";
     description?: string | undefined;
+    title?: string | undefined;
     taskId?: number | undefined;
     priority?: number | undefined;
+    status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
 }>;
 export declare const VerifySchema: z.ZodObject<{
     project: z.ZodString;
     gates: z.ZodDefault<z.ZodArray<z.ZodEnum<["build", "test", "lint"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    gates: ("build" | "test" | "lint")[];
+    gates: ("test" | "build" | "lint")[];
 }, {
     project: string;
-    gates?: ("build" | "test" | "lint")[] | undefined;
+    gates?: ("test" | "build" | "lint")[] | undefined;
 }>;
 export declare const LearnSchema: z.ZodObject<{
     project: z.ZodString;
@@ -145,32 +145,32 @@ export declare const LearnSchema: z.ZodObject<{
     toVersion: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    type: "decision" | "pattern" | "dependency" | "fix";
     content: string;
+    type: "fix" | "pattern" | "decision" | "dependency";
+    solution?: string | undefined;
+    action?: "remove" | "add" | "upgrade" | "downgrade" | undefined;
+    dependency?: string | undefined;
     reason?: string | undefined;
-    alternatives?: string[] | undefined;
     files?: string[] | undefined;
-    solution?: string | undefined;
+    alternatives?: string[] | undefined;
     preventionTip?: string | undefined;
     example?: string | undefined;
     appliesTo?: string | undefined;
-    dependency?: string | undefined;
-    action?: "add" | "remove" | "upgrade" | "downgrade" | undefined;
     fromVersion?: string | undefined;
     toVersion?: string | undefined;
 }, {
     project: string;
-    type: "decision" | "pattern" | "dependency" | "fix";
     content: string;
+    type: "fix" | "pattern" | "decision" | "dependency";
+    solution?: string | undefined;
+    action?: "remove" | "add" | "upgrade" | "downgrade" | undefined;
+    dependency?: string | undefined;
     reason?: string | undefined;
-    alternatives?: string[] | undefined;
     files?: string[] | undefined;
-    solution?: string | undefined;
+    alternatives?: string[] | undefined;
     preventionTip?: string | undefined;
     example?: string | undefined;
     appliesTo?: string | undefined;
-    dependency?: string | undefined;
-    action?: "add" | "remove" | "upgrade" | "downgrade" | undefined;
     fromVersion?: string | undefined;
     toVersion?: string | undefined;
 }>;
@@ -210,15 +210,15 @@ export declare const ToolSchemas: {
         project: string;
         currentState: string;
         verification?: "passed" | "failed" | undefined;
-        recentFiles?: string[] | undefined;
         blockers?: string | undefined;
+        recentFiles?: string[] | undefined;
         architectureDecision?: string | undefined;
     }, {
         project: string;
         currentState: string;
         verification?: "passed" | "failed" | undefined;
-        recentFiles?: string[] | undefined;
         blockers?: string | undefined;
+        recentFiles?: string[] | undefined;
         architectureDecision?: string | undefined;
     }>;
     readonly memory_store: z.ZodObject<{
@@ -229,15 +229,15 @@ export declare const ToolSchemas: {
         importance: z.ZodDefault<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
-        type: "error" | "observation" | "decision" | "learning" | "pattern" | "preference";
         content: string;
+        type: "pattern" | "observation" | "decision" | "learning" | "error" | "preference";
         importance: number;
         project?: string | undefined;
         tags?: string[] | undefined;
         metadata?: Record<string, unknown> | undefined;
     }, {
-        type: "error" | "observation" | "decision" | "learning" | "pattern" | "preference";
         content: string;
+        type: "pattern" | "observation" | "decision" | "learning" | "error" | "preference";
         project?: string | undefined;
         tags?: string[] | undefined;
         importance?: number | undefined;
@@ -252,20 +252,20 @@ export declare const ToolSchemas: {
         minImportance: z.ZodDefault<z.ZodNumber>;
         detail: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        limit: number;
         query: string;
-        minImportance: number;
+        limit: number;
         semantic: boolean;
+        minImportance: number;
         detail: boolean;
         project?: string | undefined;
-        type?: "error" | "observation" | "decision" | "learning" | "pattern" | "preference" | undefined;
+        type?: "pattern" | "observation" | "decision" | "learning" | "error" | "preference" | undefined;
     }, {
         query: string;
         project?: string | undefined;
-        type?: "error" | "observation" | "decision" | "learning" | "pattern" | "preference" | undefined;
         limit?: number | undefined;
-        minImportance?: number | undefined;
         semantic?: boolean | undefined;
+        type?: "pattern" | "observation" | "decision" | "learning" | "error" | "preference" | undefined;
+        minImportance?: number | undefined;
         detail?: boolean | undefined;
     }>;
     readonly memory_get: z.ZodObject<{
@@ -293,30 +293,30 @@ export declare const ToolSchemas: {
         status: z.ZodOptional<z.ZodEnum<["pending", "in_progress", "done", "blocked"]>>;
     }, "strip", z.ZodTypeAny, {
         project: string;
-        action: "update" | "list" | "add" | "complete";
-        title?: string | undefined;
-        status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
+        action: "update" | "add" | "list" | "complete";
         description?: string | undefined;
+        title?: string | undefined;
         taskId?: number | undefined;
         priority?: number | undefined;
+        status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
     }, {
         project: string;
-        action: "update" | "list" | "add" | "complete";
-        title?: string | undefined;
-        status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
+        action: "update" | "add" | "list" | "complete";
         description?: string | undefined;
+        title?: string | undefined;
         taskId?: number | undefined;
         priority?: number | undefined;
+        status?: "pending" | "in_progress" | "done" | "blocked" | undefined;
     }>;
     readonly verify: z.ZodObject<{
         project: z.ZodString;
         gates: z.ZodDefault<z.ZodArray<z.ZodEnum<["build", "test", "lint"]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         project: string;
-        gates: ("build" | "test" | "lint")[];
+        gates: ("test" | "build" | "lint")[];
     }, {
         project: string;
-        gates?: ("build" | "test" | "lint")[] | undefined;
+        gates?: ("test" | "build" | "lint")[] | undefined;
     }>;
     readonly learn: z.ZodObject<{
         project: z.ZodString;
@@ -335,32 +335,32 @@ export declare const ToolSchemas: {
         toVersion: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         project: string;
-        type: "decision" | "pattern" | "dependency" | "fix";
         content: string;
+        type: "fix" | "pattern" | "decision" | "dependency";
+        solution?: string | undefined;
+        action?: "remove" | "add" | "upgrade" | "downgrade" | undefined;
+        dependency?: string | undefined;
         reason?: string | undefined;
-        alternatives?: string[] | undefined;
         files?: string[] | undefined;
-        solution?: string | undefined;
+        alternatives?: string[] | undefined;
         preventionTip?: string | undefined;
         example?: string | undefined;
         appliesTo?: string | undefined;
-        dependency?: string | undefined;
-        action?: "add" | "remove" | "upgrade" | "downgrade" | undefined;
         fromVersion?: string | undefined;
         toVersion?: string | undefined;
     }, {
         project: string;
-        type: "decision" | "pattern" | "dependency" | "fix";
         content: string;
+        type: "fix" | "pattern" | "decision" | "dependency";
+        solution?: string | undefined;
+        action?: "remove" | "add" | "upgrade" | "downgrade" | undefined;
+        dependency?: string | undefined;
         reason?: string | undefined;
-        alternatives?: string[] | undefined;
         files?: string[] | undefined;
-        solution?: string | undefined;
+        alternatives?: string[] | undefined;
         preventionTip?: string | undefined;
         example?: string | undefined;
         appliesTo?: string | undefined;
-        dependency?: string | undefined;
-        action?: "add" | "remove" | "upgrade" | "downgrade" | undefined;
         fromVersion?: string | undefined;
         toVersion?: string | undefined;
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-session-continuity-mcp",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "Session continuity for Claude Code, OpenAI Codex CLI & Google Gemini CLI - never re-explain your project again. 100% local, zero config, auto context injection.",
   "type": "module",
   "main": "dist/index.js",
@@ -21,8 +21,6 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "dashboard": "node dist/dashboard.js",
-    "dashboard:v2": "node dist/dashboard-v2.js",
     "postinstall": "node dist/hooks/install.js install 2>/dev/null || true",
     "prepublishOnly": "npm run build && npm test"
   },
@@ -62,7 +60,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",

package/dist/dashboard-v2.d.ts

@@ -1,11 +0,0 @@
-#!/usr/bin/env node
-/**
- * Project Manager MCP Dashboard v2
- * Modern dashboard with:
- * - Tailwind-inspired design (CSS-only, no build step)
- * - Real-time updates
- * - Project timeline view
- * - Memory graph visualization
- * - Context snapshot viewer
- */
-export {};