superlocalmemory 2.8.6 → 3.0.1

package/bin/aider-smart

@@ -1,72 +0,0 @@
-#!/bin/bash
-# aider-smart - Aider with SuperLocalMemory context injection
-#
-# Copyright (c) 2026 Varun Pratap Bhardwaj
-# Licensed under MIT License
-#
-# Automatically injects relevant project context from SuperLocalMemory
-# when launching Aider CLI for AI-assisted coding.
-
-set -e
-
-SLM_DIR="${HOME}/.claude-memory"
-
-# Check if Aider is installed
-if ! command -v aider &> /dev/null; then
-    echo "Error: Aider not found. Install: pip install aider-chat"
-    exit 1
-fi
-
-# Check if SuperLocalMemory is installed
-if [ ! -d "$SLM_DIR" ]; then
-    echo "Error: SuperLocalMemory V2 not installed"
-    echo "Install from: https://github.com/varun369/SuperLocalMemoryV2"
-    exit 1
-fi
-
-# Generate context from current project
-project=$(basename "$PWD")
-CONTEXT_FILE="/tmp/slm-aider-context-$$.txt"
-
-echo "🧠 Gathering project context from SuperLocalMemory..."
-echo ""
-
-# Get recent project memories
-if command -v slm &> /dev/null; then
-    # Use slm command if available
-    slm context > "$CONTEXT_FILE" 2>/dev/null || {
-        "$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5 > "$CONTEXT_FILE" 2>/dev/null || true
-    }
-else
-    # Fallback to direct command
-    "$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5 > "$CONTEXT_FILE" 2>/dev/null || true
-fi
-
-# Get coding patterns if available
-if [ -f "$SLM_DIR/pattern_learner.py" ]; then
-    echo "" >> "$CONTEXT_FILE"
-    echo "## Your Coding Patterns:" >> "$CONTEXT_FILE"
-    python3 "$SLM_DIR/pattern_learner.py" context 0.6 >> "$CONTEXT_FILE" 2>/dev/null || true
-fi
-
-# Launch Aider with context
-if [ -s "$CONTEXT_FILE" ] && [ "$(wc -l < "$CONTEXT_FILE")" -gt 1 ]; then
-    echo "✓ Context loaded from SuperLocalMemory"
-    echo ""
-
-    # Pass context to Aider
-    aider \
-        --read "$CONTEXT_FILE" \
-        --message "Context from SuperLocalMemory V2 loaded. I have access to your project's memory and coding patterns." \
-        "$@"
-else
-    echo "⚠ No context found for project: $project"
-    echo "  Use: slm remember \"project info\" to save context"
-    echo ""
-
-    # Launch Aider without context
-    aider "$@"
-fi
-
-# Cleanup
-rm -f "$CONTEXT_FILE"

package/bin/superlocalmemoryv2-learning

@@ -1,4 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Learning System Status
-SLM_DIR="${HOME}/.claude-memory"
-exec "${SLM_DIR}/bin/slm" learning "${@:-status}"

package/bin/superlocalmemoryv2-list

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - List Recent Memories Command Wrapper
-node ~/.claude-memory/hooks/memory-list-skill.js "$@"

package/bin/superlocalmemoryv2-patterns

@@ -1,4 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Show Learned Patterns
-SLM_DIR="${HOME}/.claude-memory"
-exec "${SLM_DIR}/bin/slm" patterns list "$@"

package/bin/superlocalmemoryv2-profile

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Profile Management Command Wrapper
-node ~/.claude-memory/hooks/memory-profile-skill.js "$@"

package/bin/superlocalmemoryv2-recall

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Recall (Search Memories) Command Wrapper
-node ~/.claude-memory/hooks/memory-recall-skill.js "$@"

package/bin/superlocalmemoryv2-remember

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Remember (Save Memory) Command Wrapper
-node ~/.claude-memory/hooks/memory-remember-skill.js "$@"

package/bin/superlocalmemoryv2-reset

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Reset Command Wrapper
-node ~/.claude-memory/hooks/memory-reset-skill.js "$@"

package/bin/superlocalmemoryv2-status

@@ -1,3 +0,0 @@
-#!/bin/bash
-# SuperLocalMemory V2 - Quick Status Check
-node ~/.claude-memory/hooks/memory-reset-skill.js status

package/configs/chatgpt-desktop-mcp.json

@@ -1,16 +0,0 @@
-{
-  "_README": "ChatGPT Integration — SuperLocalMemory V2 as ChatGPT Connector",
-  "_requires": "ChatGPT Pro/Plus/Business/Enterprise with Developer Mode enabled",
-  "_tools": "search(query) and fetch(id) — required by OpenAI MCP spec for Connectors",
-  "_setup": {
-    "step1": "Start MCP server: slm serve --port 8417",
-    "step2": "Expose via tunnel: ngrok http 8417",
-    "step3": "Copy the HTTPS URL from ngrok (e.g. https://abc123.ngrok.app)",
-    "step4": "In ChatGPT: Settings → Connectors → Advanced → Enable Developer Mode",
-    "step5": "Create new Connector → paste URL with /sse/ suffix (e.g. https://abc123.ngrok.app/sse/)",
-    "step6": "Name it 'SuperLocalMemory' and click Create",
-    "step7": "In any chat, click + → More → select SuperLocalMemory connector"
-  },
-  "_alternative_transport": "For Streamable HTTP (recommended): slm serve --transport streamable-http --port 8417",
-  "_note": "100% local — your MCP server runs on YOUR machine. The tunnel just makes it reachable by ChatGPT servers. All data stays in ~/.claude-memory/memory.db"
-}

package/configs/cursor-mcp.json

@@ -1,15 +0,0 @@
-{
-  "mcpServers": {
-    "superlocalmemory-v2": {
-      "command": "python3",
-      "args": [
-        "{{INSTALL_DIR}}/mcp_server.py"
-      ],
-      "cwd": "{{INSTALL_DIR}}",
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      },
-      "description": "SuperLocalMemory V2 - Local memory system with knowledge graphs and pattern learning"
-    }
-  }
-}

package/hooks/memory-list-skill.js

@@ -1,139 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory List CLI Skill
- * List recent memories with sorting and filtering
- */
-
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-const path = require('path');
-
-const execFileAsync = promisify(execFile);
-
-async function memoryListSkill() {
-  const memoryScript = path.join(process.env.HOME, '.claude-memory', 'memory_store_v2.py');
-  const args = process.argv.slice(2);
-
-  // Show help if --help
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log(`
-╔══════════════════════════════════════════════════════════╗
-║                                                          ║
-║     SuperLocalMemory V2 - 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
-                         • recent: Latest created first (default)
-                         • accessed: Most recently accessed
-                         • importance: Highest importance first
-  --full                 Show complete content without truncation
-
-Examples:
-  memory-list
-
-  memory-list --limit 50
-
-  memory-list --sort importance
-
-  memory-list --limit 10 --sort accessed --full
-
-Output Format:
-  • ID, Content (smart truncated), Tags, Importance
-  • Creation timestamp
-  • Access count and last accessed time
-
-Notes:
-  • Default shows last 20 memories
-  • Smart truncation: full content if <5000 chars, preview if ≥5000 chars
-  • Use --full flag to always show complete content
-  • Sort by 'accessed' to find frequently used memories
-`);
-    return;
-  }
-
-  // Parse options
-  let limit = 20;
-  let sortBy = 'recent';
-  let showFull = false;
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--limit' && i + 1 < args.length) {
-      const parsedLimit = parseInt(args[i + 1]);
-      if (parsedLimit > 0 && parsedLimit <= 1000) {
-        limit = parsedLimit;
-      } else {
-        console.error('❌ ERROR: Limit must be between 1-1000');
-        return;
-      }
-      i++;
-    } else if (arg === '--sort' && i + 1 < args.length) {
-      const validSorts = ['recent', 'accessed', 'importance'];
-      if (validSorts.includes(args[i + 1])) {
-        sortBy = args[i + 1];
-      } else {
-        console.error(`❌ ERROR: Sort must be one of: ${validSorts.join(', ')}`);
-        return;
-      }
-      i++;
-    } else if (arg === '--full') {
-      showFull = true;
-    }
-  }
-
-  // Build Python command based on sort type
-  // Note: V1 store only supports 'recent' and 'list' commands without sort flags
-  let pythonArgs = [];
-
-  if (sortBy === 'recent' || sortBy === 'accessed') {
-    pythonArgs = ['recent', limit.toString()];
-  } else {
-    // Default to list for importance or other sorts
-    pythonArgs = ['list', limit.toString()];
-  }
-
-  // Add --full flag if requested
-  if (showFull) {
-    pythonArgs.push('--full');
-  }
-
-  try {
-    const { stdout, stderr } = await execFileAsync('python3', [memoryScript, ...pythonArgs]);
-
-    if (stderr) {
-      console.error('⚠️  Warning:', stderr);
-    }
-
-    console.log(`
-╔══════════════════════════════════════════════════════════╗
-║     Recent Memories (${sortBy} | limit: ${limit})
-╚══════════════════════════════════════════════════════════╝
-`);
-
-    console.log(stdout);
-
-    // Show helpful next steps
-    console.log(`
-Next steps:
-  • Use \`memory-recall <query>\` to search memories
-  • Use \`memory-remember <content>\` to add new memories
-  • Use \`memory-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/hooks/memory-profile-skill.js

@@ -1,273 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Profile CLI Skill
- * Provides memory-profile commands for managing multiple memory contexts
- */
-
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-const path = require('path');
-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 profileScript = path.join(process.env.HOME, '.claude-memory', 'memory-profiles.py');
-  const args = process.argv.slice(2); // Get command line arguments
-
-  // Show help if no args
-  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
-    console.log(`
-╔══════════════════════════════════════════════════════════╗
-║                                                          ║
-║     SuperLocalMemory V2 - 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 (requires restart)
-  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
-
-Notes:
-  • Default profile is always available
-  • Switching profiles requires restarting Claude CLI
-  • Deleting a profile is permanent (but creates backup)
-`);
-    rl.close();
-    return;
-  }
-
-  const command = args[0];
-
-  // LIST command
-  if (command === 'list') {
-    try {
-      const { stdout } = await execFileAsync('python', [profileScript, 'list']);
-      console.log(stdout);
-    } catch (error) {
-      console.error('❌ Error:', error.message);
-    }
-    rl.close();
-    return;
-  }
-
-  // CURRENT command
-  if (command === 'current') {
-    try {
-      const { stdout } = await execFileAsync('python', [profileScript, 'current']);
-      console.log(stdout);
-    } catch (error) {
-      console.error('❌ Error:', error.message);
-    }
-    rl.close();
-    return;
-  }
-
-  // CREATE command
-  if (command === 'create') {
-    if (args.length < 2) {
-      console.log(`
-❌ ERROR: Profile name required
-
-Usage: memory-profile create <name> [options]
-
-Options:
-  --description "text"    Profile description
-  --from-current          Copy current profile's data to new profile
-
-Examples:
-  memory-profile create work
-  memory-profile create work --description "Work projects"
-  memory-profile create personal --from-current
-`);
-      rl.close();
-      return;
-    }
-
-    const profileName = args[1];
-    const pythonArgs = ['create', profileName];
-
-    // Check for --description flag
-    const descIndex = args.indexOf('--description');
-    if (descIndex !== -1 && descIndex + 1 < args.length) {
-      pythonArgs.push('--description', args[descIndex + 1]);
-    }
-
-    // Check for --from-current flag
-    if (args.includes('--from-current')) {
-      pythonArgs.push('--from-current');
-    }
-
-    try {
-      const { stdout } = await execFileAsync('python', [profileScript, ...pythonArgs]);
-      console.log(stdout);
-    } catch (error) {
-      console.error('❌ Error:', error.message);
-      if (error.stdout) console.log(error.stdout);
-    }
-    rl.close();
-    return;
-  }
-
-  // SWITCH command
-  if (command === 'switch') {
-    if (args.length < 2) {
-      console.log(`
-❌ ERROR: Profile name required
-
-Usage: memory-profile switch <name>
-
-Example:
-  memory-profile switch work
-
-After switching, restart Claude CLI for changes to take effect.
-`);
-      rl.close();
-      return;
-    }
-
-    const profileName = args[1];
-
-    console.log(`
-╔══════════════════════════════════════════════════════════╗
-║              Profile Switch                              ║
-╚══════════════════════════════════════════════════════════╝
-
-This will switch the active profile to "${profileName}".
-All profiles share one database — switching is instant and safe.
-Your current memories are always preserved.
-`);
-
-    const answer = await question('Proceed with profile switch? (yes/no): ');
-
-    if (answer.toLowerCase() === 'yes') {
-      try {
-        const { stdout } = await execFileAsync('python', [
-          profileScript,
-          'switch',
-          profileName
-        ]);
-        console.log(stdout);
-      } catch (error) {
-        console.error('❌ Error:', error.message);
-        if (error.stdout) console.log(error.stdout);
-      }
-    } else {
-      console.log('\nCancelled. No changes made.');
-    }
-
-    rl.close();
-    return;
-  }
-
-  // DELETE command
-  if (command === 'delete') {
-    if (args.length < 2) {
-      console.log(`
-❌ ERROR: Profile name required
-
-Usage: memory-profile delete <name>
-
-Example:
-  memory-profile delete old-project
-
-Cannot delete:
-  • The "default" profile
-  • The currently active profile
-`);
-      rl.close();
-      return;
-    }
-
-    const profileName = args[1];
-
-    // Prevent deleting default
-    if (profileName === 'default') {
-      console.log(`
-❌ ERROR: Cannot delete the default profile
-
-The default profile is protected and cannot be deleted.
-`);
-      rl.close();
-      return;
-    }
-
-    console.log(`
-╔══════════════════════════════════════════════════════════╗
-║              ⚠️  DELETE PROFILE WARNING ⚠️               ║
-╚══════════════════════════════════════════════════════════╝
-
-This will PERMANENTLY delete profile: "${profileName}"
-
-What will be deleted:
-  🔴 All memories in this profile
-  🔴 Graph data (nodes, edges, clusters)
-  🔴 Learned patterns
-  🔴 Compressed archives
-
-A backup will be created before deletion.
-
-`);
-
-    const answer = await question(`Type the profile name "${profileName}" to confirm: `);
-
-    if (answer === profileName) {
-      try {
-        const { stdout } = await execFileAsync('python', [
-          profileScript,
-          'delete',
-          profileName
-        ]);
-        console.log(stdout);
-      } catch (error) {
-        console.error('❌ Error:', error.message);
-        if (error.stdout) console.log(error.stdout);
-      }
-    } else {
-      console.log('\nCancelled. No changes made.');
-      console.log(`(You must type exactly "${profileName}" to confirm)`);
-    }
-
-    rl.close();
-    return;
-  }
-
-  // Unknown command
-  console.log(`
-❌ Unknown command: ${command}
-
-Valid commands: list, current, create, switch, delete
-
-Use: memory-profile --help for more information
-`);
-  rl.close();
-}
-
-memoryProfileSkill();

package/hooks/memory-recall-skill.js

@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Recall CLI Skill
- * Search and retrieve memories with advanced filtering
- */
-
-const { execFile } = require('child_process');
-const { promisify } = require('util');
-const path = require('path');
-
-const execFileAsync = promisify(execFile);
-
-async function memoryRecallSkill() {
-  const memoryScript = path.join(process.env.HOME, '.claude-memory', 'memory_store_v2.py');
-  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 V2 - Recall (Search Memories)       ║
-║                                                          ║
-╚══════════════════════════════════════════════════════════╝
-
-Search your memory store using semantic search and filters.
-Finds relevant memories using TF-IDF similarity and metadata.
-
-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
-
-  memory-recall "user preferences"
-
-Output Format:
-  • Ranked by relevance (TF-IDF cosine similarity)
-  • Shows: ID, Content, Tags, Importance, Timestamp
-  • Higher scores = better matches
-  • Smart truncation: full content if <5000 chars, preview if ≥5000 chars
-  • Use --full flag to always show complete content
-
-Notes:
-  • Uses local TF-IDF search (no external APIs)
-  • Searches content, summary, and tags
-  • Empty query returns recent memories
-  • Use quotes for multi-word queries
-`);
-    return;
-  }
-
-  // Parse query and options
-  let query = null;
-  const pythonArgs = ['search'];
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    if (arg === '--limit' && i + 1 < args.length) {
-      // Note: V1 store doesn't support --limit in search, will truncate output instead
-      i++; // Skip but don't add to pythonArgs
-    } else if (arg === '--full') {
-      pythonArgs.push('--full');
-    } else if (!arg.startsWith('--') && query === null) {
-      query = arg;
-    }
-  }
-
-  // Validate query
-  if (!query || query.trim().length === 0) {
-    console.log(`
-❌ ERROR: Search query required
-
-Usage: memory-recall <query> [options]
-
-Example:
-  memory-recall "search term" --limit 10
-
-Use --help for more information
-`);
-    return;
-  }
-
-  // Add query to Python args
-  pythonArgs.push(query);
-
-  try {
-    const { stdout, stderr } = await execFileAsync('python3', [memoryScript, ...pythonArgs]);
-
-    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();