superlocalmemory 2.8.5 → 3.0.0

package/{configs → ide/configs}/codex-mcp.toml

@@ -1,13 +1,13 @@
-# SuperLocalMemory V2 - Codex CLI MCP Configuration
+# SuperLocalMemory V3 - Codex CLI MCP Configuration
 # Copyright (c) 2026 Varun Pratap Bhardwaj
 # Licensed under MIT License
 #
 # Auto-configured by install.sh or use: codex mcp add
 # Manual: Copy this to ~/.codex/config.toml
 
-[mcp_servers.superlocalmemory-v2]
+[mcp_servers.superlocalmemory]
 command = "python3"
-args = ["{{INSTALL_DIR}}/mcp_server.py"]
+args = ["-m", "superlocalmemory.mcp.server"]
 
-[mcp_servers.superlocalmemory-v2.env]
+[mcp_servers.superlocalmemory.env]
 PYTHONPATH = "{{INSTALL_DIR}}"

package/{configs → ide/configs}/continue-mcp.yaml

@@ -4,11 +4,12 @@
 contextProviders:
   - name: mcp
     params:
-      serverName: "superlocalmemory-v2"
+      serverName: "superlocalmemory"
       command: "python3"
       args:
-        - "{{INSTALL_DIR}}/mcp_server.py"
-      description: "SuperLocalMemory V2 - Search your memory system"
+        - "-m"
+        - "superlocalmemory.mcp.server"
+      description: "SuperLocalMemory V3 - Search your memory system"
 
 # You can also use Continue's slash commands with SuperLocalMemory
 # See continue-skills.yaml for slash command configuration

package/{configs → ide/configs}/continue-skills.yaml

@@ -1,23 +1,23 @@
-# Continue.dev Slash Commands for SuperLocalMemory V2
-# These map to your existing bash scripts (no duplicate logic)
+# Continue.dev Slash Commands for SuperLocalMemory V3
+# These map to the V3 CLI commands
 # Add this to ~/.continue/config.yaml
 
 slashCommands:
   - name: "slm-remember"
     description: "Save to SuperLocalMemory"
-    run: "~/.claude-memory/bin/superlocalmemoryv2-remember \"{{input}}\""
+    run: "slm remember \"{{input}}\""
 
   - name: "slm-recall"
     description: "Search SuperLocalMemory"
-    run: "~/.claude-memory/bin/superlocalmemoryv2-recall \"{{input}}\""
+    run: "slm recall \"{{input}}\""
 
   - name: "slm-list"
     description: "List recent memories"
-    run: "~/.claude-memory/bin/superlocalmemoryv2-list"
+    run: "slm list"
 
   - name: "slm-status"
     description: "SuperLocalMemory system status"
-    run: "~/.claude-memory/bin/superlocalmemoryv2-status"
+    run: "slm status"
 
 # Usage in Continue.dev:
 #   /slm-remember Use FastAPI for REST APIs

package/ide/configs/cursor-mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "command": "python3",
+      "args": [
+        "-m", "superlocalmemory.mcp.server"
+      ],
+      "cwd": "{{INSTALL_DIR}}",
+      "env": {
+        "PYTHONPATH": "{{INSTALL_DIR}}"
+      },
+      "description": "SuperLocalMemory V3 - Local memory system with mathematical foundations and knowledge graphs"
+    }
+  }
+}

package/{configs → ide/configs}/gemini-cli-mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "command": "python3",
-      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "args": ["-m", "superlocalmemory.mcp.server"],
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       }

package/{configs → ide/configs}/jetbrains-mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "command": "python3",
-      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "args": ["-m", "superlocalmemory.mcp.server"],
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       }

package/{configs → ide/configs}/opencode-mcp.json

@@ -1,8 +1,8 @@
 {
   "mcp": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "command": "python3",
-      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "args": ["-m", "superlocalmemory.mcp.server"],
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       },

package/{configs → ide/configs}/perplexity-mcp.json

@@ -1,7 +1,7 @@
 {
-  "superlocalmemory-v2": {
+  "superlocalmemory": {
     "command": "python3",
-    "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+    "args": ["-m", "superlocalmemory.mcp.server"],
     "env": {
       "PYTHONPATH": "{{INSTALL_DIR}}"
     }

package/{configs → ide/configs}/vscode-copilot-mcp.json

@@ -1,9 +1,9 @@
 {
   "servers": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "type": "stdio",
       "command": "python3",
-      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "args": ["-m", "superlocalmemory.mcp.server"],
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       }

package/{configs → ide/configs}/windsurf-mcp.json

@@ -1,16 +1,16 @@
 {
   "mcpServers": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "command": "python3",
       "args": [
-        "{{INSTALL_DIR}}/mcp_server.py"
+        "-m", "superlocalmemory.mcp.server"
       ],
       "cwd": "{{INSTALL_DIR}}",
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       },
       "transport": "stdio",
-      "description": "SuperLocalMemory V2 - 100% local memory system for AI assistants"
+      "description": "SuperLocalMemory V3 - 100% local memory system for AI assistants"
     }
   }
 }

package/{configs → ide/configs}/zed-mcp.json

@@ -1,9 +1,9 @@
 {
   "context_servers": {
-    "superlocalmemory-v2": {
+    "superlocalmemory": {
       "source": "custom",
       "command": "python3",
-      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "args": ["-m", "superlocalmemory.mcp.server"],
       "env": {
         "PYTHONPATH": "{{INSTALL_DIR}}"
       }

package/{hooks → ide/hooks}/context-hook.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /**
- * SuperLocalMemory V2 - Session Start Context Hook
+ * SuperLocalMemory V3 - Session Start Context Hook
  * Copyright (c) 2026 Varun Pratap Bhardwaj
  * Licensed under MIT License
  *
  * Loads recent memories and learned patterns on Claude Code session start.
  * Outputs context to stderr (Claude Code reads hook stderr as context).
- * Fails gracefully — never blocks session start if DB is missing or errors occur.
+ * Fails gracefully -- never blocks session start if DB is missing or errors occur.
  */
 
 const { execFile } = require('child_process');
@@ -16,9 +16,8 @@ const fs = require('fs');
 
 const execFileAsync = promisify(execFile);
 
-const MEMORY_DIR = path.join(process.env.HOME, '.claude-memory');
+const MEMORY_DIR = path.join(process.env.HOME, '.superlocalmemory');
 const DB_PATH = path.join(MEMORY_DIR, 'memory.db');
-const MEMORY_SCRIPT = path.join(MEMORY_DIR, 'memory_store_v2.py');
 
 async function loadSessionContext() {
   // Fail gracefully if not installed
@@ -26,19 +25,10 @@ async function loadSessionContext() {
     return;
   }
 
-  if (!fs.existsSync(MEMORY_SCRIPT)) {
-    return;
-  }
-
   try {
-    // Get stats (memory_store_v2.py stats → JSON output)
+    // Get stats via V3 CLI
     const { stdout: statsOutput } = await execFileAsync('python3', [
-      MEMORY_SCRIPT, 'stats'
-    ], { timeout: 5000 });
-
-    // Get recent memories (memory_store_v2.py list <limit>)
-    const { stdout: recentOutput } = await execFileAsync('python3', [
-      MEMORY_SCRIPT, 'list', '5'
+      '-m', 'superlocalmemory.cli.main', 'status', '--format', 'json'
     ], { timeout: 5000 });
 
     // Build context output
@@ -48,13 +38,12 @@ async function loadSessionContext() {
       try {
         const stats = JSON.parse(statsOutput.trim());
         const total = stats.total_memories || 0;
-        const clusters = stats.total_clusters || 0;
         if (total > 0) {
-          context += 'SuperLocalMemory: ' + total + ' memories, ' + clusters + ' clusters loaded.\n';
+          context += 'SuperLocalMemory V3: ' + total + ' memories loaded.\n';
         }
       } catch (e) {
-        // Stats output wasn't JSON — use first line as-is
-        context += 'SuperLocalMemory: ' + statsOutput.trim().split('\n')[0] + '\n';
+        // Stats output wasn't JSON -- use first line as-is
+        context += 'SuperLocalMemory V3: ' + statsOutput.trim().split('\n')[0] + '\n';
       }
     }
 
@@ -62,7 +51,7 @@ async function loadSessionContext() {
       process.stderr.write(context);
     }
   } catch (error) {
-    // Never fail — session start must not be blocked
+    // Never fail -- session start must not be blocked
     // Silently ignore errors (timeout, missing python, etc.)
   }
 }

package/ide/hooks/memory-list-skill.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * Memory List CLI Skill (V3)
+ * List recent memories with sorting and filtering
+ */
+
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+
+const execFileAsync = promisify(execFile);
+
+async function memoryListSkill() {
+  const args = process.argv.slice(2);
+
+  // Show help if --help
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(`
+SuperLocalMemory V3 - List Recent Memories
+
+Display recent memories with optional sorting and limits.
+Quick overview of what's stored in your memory database.
+
+Usage: memory-list [options]
+
+Options:
+  --limit <n>            Number of memories to show (default: 20)
+  --sort <field>         Sort by: recent, accessed, importance
+  --full                 Show complete content without truncation
+
+Examples:
+  memory-list
+  memory-list --limit 50
+  memory-list --sort importance
+  memory-list --limit 10 --sort accessed --full
+`);
+    return;
+  }
+
+  // Build CLI args for V3
+  const cliArgs = ['-m', 'superlocalmemory.cli.main', 'list'];
+
+  for (let i = 0; i < args.length; i++) {
+    cliArgs.push(args[i]);
+  }
+
+  try {
+    const { stdout, stderr } = await execFileAsync('python3', cliArgs);
+
+    if (stderr) {
+      console.error('Warning:', stderr);
+    }
+
+    console.log(stdout);
+
+    // Show helpful next steps
+    console.log(`
+Next steps:
+  - Use \`slm recall <query>\` to search memories
+  - Use \`slm remember <content>\` to add new memories
+  - Use \`slm list --sort <field>\` to change sort order
+`);
+
+  } catch (error) {
+    console.error('Error listing memories:', error.message);
+    if (error.stdout) console.log(error.stdout);
+    if (error.stderr) console.error(error.stderr);
+  }
+}
+
+memoryListSkill();

package/ide/hooks/memory-profile-skill.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * Memory Profile CLI Skill (V3)
+ * Provides memory-profile commands for managing multiple memory contexts
+ */
+
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+const readline = require('readline');
+
+const execFileAsync = promisify(execFile);
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+const question = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+async function memoryProfileSkill() {
+  const args = process.argv.slice(2);
+
+  // Show help if no args
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    console.log(`
+SuperLocalMemory V3 - Profile Management
+
+Profiles let you maintain separate memory contexts in ONE database:
+  - Work vs Personal projects
+  - Different clients or teams
+  - Experimentation vs Production
+
+All profiles share one database. Switching is instant and safe.
+No data copying, no data loss risk.
+
+Usage: memory-profile <command> [options]
+
+Commands:
+  list                List all profiles and show active one
+  current             Show current active profile
+  create <name>       Create a new empty profile
+  switch <name>       Switch to a different profile
+  delete <name>       Delete a profile (with confirmation)
+
+Examples:
+  memory-profile list
+  memory-profile current
+  memory-profile create work
+  memory-profile switch work
+  memory-profile delete old-project
+`);
+    rl.close();
+    return;
+  }
+
+  const command = args[0];
+  const cliArgs = ['-m', 'superlocalmemory.cli.main', 'profile', ...args];
+
+  // For destructive operations, add confirmation prompts
+  if (command === 'delete' && args.length >= 2) {
+    const profileName = args[1];
+
+    if (profileName === 'default') {
+      console.log('Error: Cannot delete the default profile.');
+      rl.close();
+      return;
+    }
+
+    const answer = await question(`Type the profile name "${profileName}" to confirm deletion: `);
+
+    if (answer !== profileName) {
+      console.log('\nCancelled. No changes made.');
+      rl.close();
+      return;
+    }
+  }
+
+  if (command === 'switch' && args.length >= 2) {
+    const profileName = args[1];
+    const answer = await question(`Switch to profile "${profileName}"? (yes/no): `);
+
+    if (answer.toLowerCase() !== 'yes') {
+      console.log('\nCancelled. No changes made.');
+      rl.close();
+      return;
+    }
+  }
+
+  try {
+    const { stdout, stderr } = await execFileAsync('python3', cliArgs);
+    if (stdout) console.log(stdout);
+    if (stderr) console.error(stderr);
+  } catch (error) {
+    console.error('Error:', error.message);
+    if (error.stdout) console.log(error.stdout);
+  }
+
+  rl.close();
+}
+
+memoryProfileSkill();

package/ide/hooks/memory-recall-skill.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Memory Recall CLI Skill (V3)
+ * Search and retrieve memories with advanced filtering
+ */
+
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+
+const execFileAsync = promisify(execFile);
+
+async function memoryRecallSkill() {
+  const args = process.argv.slice(2);
+
+  // Show help if no args or --help
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    console.log(`
+SuperLocalMemory V3 - Recall (Search Memories)
+
+Search your memory store using hybrid retrieval (semantic, BM25, graph, temporal).
+
+Usage: memory-recall <query> [options]
+
+Arguments:
+  <query>                 Search query (required)
+
+Options:
+  --limit <n>            Maximum results to return (default: 10)
+  --full                 Show complete content without truncation
+
+Examples:
+  memory-recall "authentication bug"
+  memory-recall "API configuration" --limit 5
+  memory-recall "security best practices" --full
+`);
+    return;
+  }
+
+  // Build V3 CLI args
+  const cliArgs = ['-m', 'superlocalmemory.cli.main', 'recall'];
+
+  for (let i = 0; i < args.length; i++) {
+    cliArgs.push(args[i]);
+  }
+
+  try {
+    const { stdout, stderr } = await execFileAsync('python3', cliArgs);
+
+    if (stderr) {
+      console.error('Warning:', stderr);
+    }
+
+    console.log(stdout);
+
+  } catch (error) {
+    console.error('Error searching memories:', error.message);
+    if (error.stdout) console.log(error.stdout);
+    if (error.stderr) console.error(error.stderr);
+  }
+}
+
+memoryRecallSkill();

package/ide/hooks/memory-remember-skill.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+/**
+ * Memory Remember CLI Skill (V3)
+ * Save memories with tags, project context, and importance levels
+ */
+
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+
+const execFileAsync = promisify(execFile);
+
+async function memoryRememberSkill() {
+  const args = process.argv.slice(2);
+
+  // Show help if no args or --help
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    console.log(`
+SuperLocalMemory V3 - Remember (Save Memory)
+
+Save important information to your persistent memory store.
+Memories are indexed, searchable, and integrated with the knowledge graph.
+
+Usage: memory-remember <content> [options]
+
+Arguments:
+  <content>               The memory content to save (required)
+
+Options:
+  --tags <tag1,tag2>      Comma-separated tags for categorization
+  --project <path>        Project path context
+
+Examples:
+  memory-remember "API key stored in .env file" --tags security,config
+  memory-remember "User prefers tabs over spaces"
+  memory-remember "Bug in auth.js line 42" --project ~/work/app --tags bug
+`);
+    return;
+  }
+
+  // Build V3 CLI args
+  const cliArgs = ['-m', 'superlocalmemory.cli.main', 'remember'];
+
+  for (let i = 0; i < args.length; i++) {
+    cliArgs.push(args[i]);
+  }
+
+  try {
+    const { stdout, stderr } = await execFileAsync('python3', cliArgs);
+
+    if (stderr) {
+      console.error('Warning:', stderr);
+    }
+
+    console.log(stdout);
+
+    // Show helpful next steps
+    console.log('Next steps:');
+    console.log('  - Use `slm recall <query>` to search this memory');
+    console.log('  - Use `slm list` to see recent memories');
+
+  } catch (error) {
+    console.error('Error saving memory:', error.message);
+    if (error.stdout) console.log(error.stdout);
+    if (error.stderr) console.error(error.stderr);
+  }
+}
+
+memoryRememberSkill();