claude-code-memory 1.0.0

package/dist/install.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * install.ts - Set up memory-mcp for a project or globally.
+ *
+ * Usage:
+ *   node dist/install.js <project-dir>           # Per-project install
+ *   node dist/install.js --global                 # Global install (all projects)
+ *   node dist/install.js --api-key <key>          # Store API key globally
+ *   node dist/install.js --global --api-key <key> # Both
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const args = process.argv.slice(2);
+const isGlobal = args.includes("--global");
+const apiKeyIdx = args.indexOf("--api-key");
+const apiKey = apiKeyIdx !== -1 ? args[apiKeyIdx + 1] : null;
+const projectDir = args.find((a) => !a.startsWith("--") && a !== apiKey);
+const memoryMcpDir = path.resolve(__dirname, "..");
+const extractorPath = path.join(memoryMcpDir, "dist", "extractor.js");
+const serverPath = path.join(memoryMcpDir, "dist", "index.js");
+const homeDir = process.env.HOME || "";
+if (!isGlobal && !projectDir && !apiKey) {
+    console.error(`Usage:
+  memory-mcp-install <project-dir>             Per-project install
+  memory-mcp-install --global                  Global install (all projects)
+  memory-mcp-install --api-key <key>           Store API key
+  memory-mcp-install --global --api-key <key>  Both`);
+    process.exit(1);
+}
+// --- Store API Key ---
+if (apiKey) {
+    const configDir = path.join(homeDir, ".memory-mcp");
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    const configPath = path.join(configDir, "config.json");
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    config.apiKey = apiKey;
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`  ✓ API key stored in ~/.memory-mcp/config.json`);
+}
+// --- Hook Config ---
+const hookCommand = `node ${extractorPath}`;
+const hookEntry = {
+    hooks: [{ type: "command", command: hookCommand, timeout: 30 }],
+};
+function installHooks(settingsPath) {
+    const dir = path.dirname(settingsPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+        settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    }
+    if (!settings.hooks)
+        settings.hooks = {};
+    for (const event of ["Stop", "PreCompact", "SessionEnd"]) {
+        if (!settings.hooks[event]) {
+            settings.hooks[event] = [];
+        }
+        const alreadyInstalled = settings.hooks[event].some((h) => h.hooks?.some((hh) => hh.command?.includes("memory-mcp")));
+        if (!alreadyInstalled) {
+            settings.hooks[event].push(hookEntry);
+            console.log(`  ✓ Added ${event} hook`);
+        }
+        else {
+            console.log(`  · ${event} hook already exists`);
+        }
+    }
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+}
+// --- Global Install ---
+if (isGlobal) {
+    console.log(`\nInstalling memory-mcp globally\n`);
+    // Hooks in ~/.claude/settings.json
+    const globalSettingsPath = path.join(homeDir, ".claude", "settings.json");
+    installHooks(globalSettingsPath);
+    console.log(`
+Done! memory-mcp hooks installed globally.
+
+How it works:
+  1. Claude works normally in any project — no commands needed
+  2. After each response, a hook silently reads the transcript
+  3. A fast LLM extracts important memories to .memory/ in the project
+  4. Memories sync to CLAUDE.md automatically
+  5. New sessions read CLAUDE.md → instant context recovery
+
+To also add the MCP server (for search/ask tools), add to each project's .mcp.json:
+  {
+    "mcpServers": {
+      "memory": {
+        "command": "node",
+        "args": ["${serverPath}"]
+      }
+    }
+  }
+
+Or run: memory-mcp-install <project-dir>  (for per-project MCP)
+`);
+}
+// --- Per-Project Install ---
+if (projectDir) {
+    const absProjectDir = path.resolve(projectDir);
+    console.log(`\nInstalling memory-mcp for: ${absProjectDir}\n`);
+    // 1. Create .memory directory
+    const memDir = path.join(absProjectDir, ".memory");
+    if (!fs.existsSync(memDir)) {
+        fs.mkdirSync(memDir, { recursive: true });
+        console.log("  ✓ Created .memory/");
+    }
+    else {
+        console.log("  · .memory/ already exists");
+    }
+    // 2. Hooks (project-level)
+    const settingsPath = path.join(absProjectDir, ".claude", "settings.json");
+    installHooks(settingsPath);
+    // 3. MCP server config
+    const mcpPath = path.join(absProjectDir, ".mcp.json");
+    let mcpConfig = {};
+    if (fs.existsSync(mcpPath)) {
+        mcpConfig = JSON.parse(fs.readFileSync(mcpPath, "utf-8"));
+    }
+    if (!mcpConfig.mcpServers)
+        mcpConfig.mcpServers = {};
+    if (!mcpConfig.mcpServers.memory) {
+        mcpConfig.mcpServers.memory = {
+            command: "node",
+            args: [serverPath, absProjectDir],
+        };
+        console.log("  ✓ Added MCP server to .mcp.json");
+    }
+    else {
+        console.log("  · MCP server already in .mcp.json");
+    }
+    fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2));
+    // 4. .gitignore
+    const gitignorePath = path.join(absProjectDir, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+        const gitignore = fs.readFileSync(gitignorePath, "utf-8");
+        if (!gitignore.includes(".memory")) {
+            fs.appendFileSync(gitignorePath, "\n# Memory MCP\n.memory/\n");
+            console.log("  ✓ Added .memory/ to .gitignore");
+        }
+        else {
+            console.log("  · .memory/ already in .gitignore");
+        }
+    }
+    else {
+        fs.writeFileSync(gitignorePath, "# Memory MCP\n.memory/\n");
+        console.log("  ✓ Created .gitignore with .memory/");
+    }
+    console.log(`
+Done! memory-mcp installed for ${absProjectDir}.
+
+MCP Tools available:
+  memory_search   — keyword search across all memories
+  memory_related  — get memories by tag/area
+  memory_ask      — ask a question, get synthesized answer
+  memory_save     — manually save a memory
+  memory_recall   — list all memories
+  memory_stats    — show memory statistics
+  memory_consolidate — merge/prune memories
+`);
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/llm.d.ts

@@ -0,0 +1,13 @@
+import { Memory } from "./types";
+/**
+ * Shared LLM utilities: API key resolution and Anthropic API calls.
+ */
+export declare function resolveApiKey(): Promise<string | null>;
+export declare function callHaiku(prompt: string, maxTokens?: number): Promise<string | null>;
+export declare function buildExtractionPrompt(existingMemories: Memory[], transcript: string): string;
+export declare function buildConsolidationPrompt(type: string, memories: {
+    id: string;
+    content: string;
+}[]): string;
+export declare function buildAskPrompt(question: string, memories: Memory[]): string;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;GAEG;AAEH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB5D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsBhG;AAED,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAuC5F;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GAC1C,MAAM,CAsBR;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAW3E"}

package/dist/llm.js

@@ -0,0 +1,165 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiKey = resolveApiKey;
+exports.callHaiku = callHaiku;
+exports.buildExtractionPrompt = buildExtractionPrompt;
+exports.buildConsolidationPrompt = buildConsolidationPrompt;
+exports.buildAskPrompt = buildAskPrompt;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Shared LLM utilities: API key resolution and Anthropic API calls.
+ */
+async function resolveApiKey() {
+    // 1. Explicit env var
+    if (process.env.ANTHROPIC_API_KEY)
+        return process.env.ANTHROPIC_API_KEY;
+    // 2. Global memory-mcp config
+    const globalConfig = path.join(process.env.HOME || "", ".memory-mcp", "config.json");
+    if (fs.existsSync(globalConfig)) {
+        try {
+            const cfg = JSON.parse(fs.readFileSync(globalConfig, "utf-8"));
+            if (cfg.apiKey)
+                return cfg.apiKey;
+        }
+        catch { }
+    }
+    // 3. Claude CLI config paths
+    const candidates = [
+        path.join(process.env.HOME || "", ".config", "anthropic", "api_key"),
+        path.join(process.env.HOME || "", ".anthropic", "api_key"),
+    ];
+    for (const p of candidates) {
+        if (fs.existsSync(p))
+            return fs.readFileSync(p, "utf-8").trim();
+    }
+    return null;
+}
+async function callHaiku(prompt, maxTokens = 1024) {
+    const key = await resolveApiKey();
+    if (!key)
+        return null;
+    const response = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": key,
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model: "claude-3-5-haiku-20241022",
+            max_tokens: maxTokens,
+            messages: [{ role: "user", content: prompt }],
+        }),
+    });
+    if (!response.ok)
+        return null;
+    const data = (await response.json());
+    return data.content?.[0]?.text || null;
+}
+function buildExtractionPrompt(existingMemories, transcript) {
+    const existingSummary = existingMemories
+        .filter((m) => !m.tags.includes("superseded") && (m.confidence ?? 1) > 0.3)
+        .map((m) => `  [${m.type}] ${m.content}`)
+        .join("\n");
+    return `You are a memory extractor for a coding project. Analyze the conversation transcript and extract ONLY important new memories.
+
+EXISTING MEMORIES (do NOT duplicate these — only add NEW info or UPDATES):
+${existingSummary || "  (none yet)"}
+
+Extract only memories that are:
+- NEW information not covered above
+- UPDATES to existing memories (something changed — include "supersedes_content" with the OLD text)
+- CORRECTIONS to existing memories
+
+Categories:
+- architecture: System structure, components, tech stack
+- decision: Why X was chosen over Y, trade-offs
+- pattern: Codebase conventions (naming, structure, approach)
+- gotcha: Non-obvious pitfalls, surprising bugs
+- progress: Completed work, in-flight tasks, blockers
+- context: Business context, deadlines, requirements, preferences
+
+Rules:
+- SKIP trivial operations (typo fixes, file reads, routine commands)
+- SKIP things obvious from code itself
+- Each memory: one clear, specific sentence with concrete details (file names, function names)
+- If nothing new, return empty array
+- Be VERY selective — 0-3 memories per extraction is typical
+- Include relevant tags for categorization
+
+Return JSON only:
+[{"type": "decision", "content": "...", "tags": ["auth"], "supersedes_content": null}, ...]
+
+Empty result: []
+
+--- TRANSCRIPT ---
+${transcript}`;
+}
+function buildConsolidationPrompt(type, memories) {
+    const memList = memories.map((m) => `  ${m.id}: ${m.content}`).join("\n");
+    return `You are a memory consolidator. Below are ${memories.length} memories of type "${type}" from a coding project.
+
+Merge memories that overlap or can be combined into one clearer memory.
+Remove memories that are outdated or no longer relevant given later ones.
+Keep memories that are unique and still valuable.
+
+Return JSON only:
+{
+  "keep": ["mem_id1", "mem_id2"],
+  "merge": [
+    {"content": "merged text here", "tags": ["tag1"], "sources": ["mem_id3", "mem_id4"]}
+  ],
+  "drop": ["mem_id5"]
+}
+
+Every input memory ID must appear in exactly one of: keep, merge.sources, or drop.
+
+MEMORIES:
+${memList}`;
+}
+function buildAskPrompt(question, memories) {
+    const memList = memories
+        .map((m) => `  [${m.type}] ${m.content}`)
+        .join("\n");
+    return `You have access to project memories. Answer the question using ONLY the memories below. Be concise and specific. If the memories don't contain enough info, say so.
+
+MEMORIES:
+${memList}
+
+QUESTION: ${question}`;
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,57 @@
+import { Memory, MemoryType, ProjectState } from "./types";
+export declare function tokenize(s: string): Set<string>;
+export declare function jaccard(a: Set<string>, b: Set<string>): number;
+export declare class MemoryStore {
+    private storePath;
+    private memDir;
+    private state;
+    constructor(projectDir: string);
+    private load;
+    private save;
+    acquireLock(): boolean;
+    releaseLock(): void;
+    setProject(name: string, description: string): void;
+    incrementExtractionCount(): number;
+    getExtractionCount(): number;
+    addMemory(memory: Omit<Memory, "id" | "created" | "updated" | "confidence" | "accessCount">): Memory | null;
+    deleteMemory(id: string): boolean;
+    getActiveMemories(): Memory[];
+    getMemories(opts?: {
+        type?: string;
+        tags?: string[];
+        active?: boolean;
+    }): Memory[];
+    searchMemories(query: string, limit?: number): Memory[];
+    getRelated(tags: string[], type?: MemoryType): Memory[];
+    decayConfidence(): void;
+    needsConsolidation(): boolean;
+    /**
+     * Apply consolidation results from LLM.
+     * Called by extractor after getting LLM consolidation response.
+     */
+    applyConsolidation(results: {
+        keep: string[];
+        merge: {
+            content: string;
+            tags: string[];
+            sources: string[];
+        }[];
+        drop: string[];
+    }): void;
+    /**
+     * Get memories formatted for consolidation LLM prompt (grouped by type).
+     */
+    getMemoriesForConsolidation(): Record<string, {
+        id: string;
+        content: string;
+    }[]>;
+    getState(): ProjectState;
+    getAllMemoryCount(): {
+        active: number;
+        archived: number;
+        superseded: number;
+        total: number;
+    };
+    generateConsciousness(): string;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkC3D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAO/C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQ9D;AA+CD,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAe;gBAEhB,UAAU,EAAE,MAAM;IAS9B,OAAO,CAAC,IAAI;IAwBZ,OAAO,CAAC,IAAI;IAKZ,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,IAAI;IAInB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMnD,wBAAwB,IAAI,MAAM;IAMlC,kBAAkB,IAAI,MAAM;IAM5B,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC,GAAG,MAAM,GAAG,IAAI;IAyC3G,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAUjC,iBAAiB,IAAI,MAAM,EAAE;IAM7B,WAAW,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,EAAE;IAclF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,MAAM,EAAE;IAoB3D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE;IAkBvD,eAAe,IAAI,IAAI;IAkBvB,kBAAkB,IAAI,OAAO;IAK7B;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAsDtI;;OAEG;IACH,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAUhF,QAAQ,IAAI,YAAY;IAIxB,iBAAiB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAW5F,qBAAqB,IAAI,MAAM;CAsFhC"}