superlocalmemory 2.3.0

package/bin/slm

@@ -0,0 +1,202 @@
+#!/bin/bash
+# slm - Universal CLI wrapper for SuperLocalMemory V2
+# Simple commands that work in any terminal or script
+#
+# Copyright (c) 2026 Varun Pratap Bhardwaj
+# Licensed under MIT License
+#
+# This is a CONVENIENCE wrapper. Original commands still work:
+#   superlocalmemoryv2:remember, superlocalmemoryv2:recall, etc.
+
+set -e
+
+SLM_DIR="${HOME}/.claude-memory"
+
+# Check if SuperLocalMemory is installed
+if [ ! -d "$SLM_DIR" ]; then
+    echo "Error: SuperLocalMemory V2 not installed at $SLM_DIR"
+    echo "Please run: ./install.sh"
+    exit 1
+fi
+
+# Main command dispatcher
+case "$1" in
+    remember|save|store)
+        shift
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:remember" "$@"
+        ;;
+
+    recall|search|find)
+        shift
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:recall" "$@"
+        ;;
+
+    list|ls)
+        shift
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:list" "$@"
+        ;;
+
+    status|info|stats)
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:status"
+        ;;
+
+    profile)
+        shift
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:profile" "$@"
+        ;;
+
+    reset)
+        shift
+        # Calls existing command - no duplicate logic
+        "$SLM_DIR/bin/superlocalmemoryv2:reset" "$@"
+        ;;
+
+    serve|server)
+        PORT="${2:-8001}"
+        echo "Starting SuperLocalMemory MCP HTTP server..."
+        echo "Endpoint: http://localhost:$PORT"
+        echo ""
+        echo "For ChatGPT/remote access:"
+        echo "  1. In another terminal: ngrok http $PORT"
+        echo "  2. Copy the HTTPS URL"
+        echo "  3. Add to ChatGPT: Settings -> Apps & Connectors -> Developer Mode"
+        echo ""
+        exec python3 "$SLM_DIR/mcp_server.py" --transport http --port "$PORT"
+        ;;
+
+    context)
+        # NEW: Get context for current directory/project
+        project=$(basename "$PWD")
+        "$SLM_DIR/bin/superlocalmemoryv2:recall" "$project" --limit 5
+        ;;
+
+    graph)
+        shift
+        subcommand="$1"
+        shift
+        case "$subcommand" in
+            build)
+                python3 "$SLM_DIR/graph_engine.py" build "$@"
+                ;;
+            stats)
+                python3 "$SLM_DIR/graph_engine.py" stats "$@"
+                ;;
+            *)
+                echo "Usage: slm graph {build|stats}"
+                exit 1
+                ;;
+        esac
+        ;;
+
+    patterns)
+        shift
+        subcommand="$1"
+        shift
+        case "$subcommand" in
+            update)
+                python3 "$SLM_DIR/pattern_learner.py" update "$@"
+                ;;
+            list)
+                python3 "$SLM_DIR/pattern_learner.py" list "$@"
+                ;;
+            context)
+                python3 "$SLM_DIR/pattern_learner.py" context "$@"
+                ;;
+            *)
+                echo "Usage: slm patterns {update|list|context}"
+                exit 1
+                ;;
+        esac
+        ;;
+
+    help|--help|-h)
+        cat <<EOF
+SuperLocalMemory V2 - Universal CLI
+
+SIMPLE COMMANDS:
+  slm remember <content>    Save to memory
+  slm recall <query>        Search memories
+  slm list [N]             List N recent memories (default 10)
+  slm status               System status and statistics
+  slm context              Project context for current directory
+
+PROFILE MANAGEMENT:
+  slm profile list         List all profiles
+  slm profile create <name> Create new profile
+  slm profile switch <name> Switch to profile
+  slm profile delete <name> Delete profile
+  slm profile current      Show current profile
+
+KNOWLEDGE GRAPH:
+  slm graph build          Build/rebuild knowledge graph
+  slm graph stats          Show graph statistics
+
+PATTERN LEARNING:
+  slm patterns update      Learn patterns from memories
+  slm patterns list [threshold]  List learned patterns
+  slm patterns context [threshold]  Get coding identity context
+
+HTTP SERVER:
+  slm serve [PORT]         Start MCP HTTP server (default port 8001)
+                           For ChatGPT/remote: ngrok http PORT
+
+ADVANCED:
+  slm reset soft           Soft reset (clear memories)
+  slm reset hard --confirm Hard reset (nuclear option)
+
+ORIGINAL COMMANDS (still work):
+  superlocalmemoryv2:remember <content>
+  superlocalmemoryv2:recall <query>
+  superlocalmemoryv2:list [N]
+  superlocalmemoryv2:status
+  superlocalmemoryv2:profile <command>
+  superlocalmemoryv2:reset <type>
+
+EXAMPLES:
+  slm remember "Use FastAPI for REST APIs" --tags python,backend
+  slm recall "FastAPI patterns" --limit 5
+  slm context
+  slm graph build
+  slm patterns update
+  slm status
+
+DOCUMENTATION:
+  README: https://github.com/varun369/SuperLocalMemoryV2
+  Docs: ~/.claude-memory/docs/
+
+VERSION: 2.3.0-universal
+EOF
+        ;;
+
+    version|--version|-v)
+        echo "SuperLocalMemory V2 - Universal CLI"
+        echo "Version: 2.3.0-universal"
+        echo "Database: $SLM_DIR/memory.db"
+        ;;
+
+    *)
+        echo "SuperLocalMemory V2 - Universal CLI"
+        echo ""
+        echo "Usage: slm <command> [args]"
+        echo ""
+        echo "Commands:"
+        echo "  remember  - Save to memory"
+        echo "  recall    - Search memories"
+        echo "  list      - List recent memories"
+        echo "  status    - System status"
+        echo "  context   - Project context"
+        echo "  serve     - Start MCP HTTP server"
+        echo "  profile   - Manage profiles"
+        echo "  graph     - Knowledge graph operations"
+        echo "  patterns  - Pattern learning"
+        echo "  help      - Show detailed help"
+        echo ""
+        echo "Run 'slm help' for more information"
+        exit 1
+        ;;
+esac

package/bin/slm-npm

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * SuperLocalMemory V2 - NPM Global CLI Wrapper
+ *
+ * Copyright (c) 2026 Varun Pratap Bhardwaj
+ * Solution Architect & Original Creator
+ *
+ * Licensed under MIT License (see LICENSE file)
+ * Repository: https://github.com/varun369/SuperLocalMemoryV2
+ *
+ * ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
+ */
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+// Installation directory
+const SLM_DIR = path.join(os.homedir(), '.claude-memory');
+
+// Check if SuperLocalMemory is installed
+if (!fs.existsSync(SLM_DIR)) {
+    console.error('Error: SuperLocalMemory V2 not installed at ' + SLM_DIR);
+    console.error('Installation should have run automatically via postinstall script.');
+    console.error('Please run manually:');
+
+    if (os.platform() === 'win32') {
+        console.error('  powershell -ExecutionPolicy Bypass -File "' + path.join(__dirname, '..', 'install.ps1') + '"');
+    } else {
+        console.error('  bash "' + path.join(__dirname, '..', 'install.sh') + '"');
+    }
+    process.exit(1);
+}
+
+// Platform-specific slm script path
+let slmScript;
+if (os.platform() === 'win32') {
+    slmScript = path.join(SLM_DIR, 'bin', 'slm.cmd');
+    if (!fs.existsSync(slmScript)) {
+        slmScript = path.join(SLM_DIR, 'bin', 'slm');
+    }
+} else {
+    slmScript = path.join(SLM_DIR, 'bin', 'slm');
+}
+
+// Check if slm script exists
+if (!fs.existsSync(slmScript)) {
+    console.error('Error: SLM CLI not found at ' + slmScript);
+    console.error('Installation may be incomplete. Please run install script manually.');
+    process.exit(1);
+}
+
+// Pass all arguments to the real slm command
+const args = process.argv.slice(2);
+
+// Use spawnSync for secure execution (no shell injection risk)
+let result;
+if (os.platform() === 'win32') {
+    // Windows: Use cmd or PowerShell
+    result = spawnSync(slmScript, args, {
+        stdio: 'inherit',
+        shell: true
+    });
+} else {
+    // Mac/Linux: Direct bash execution
+    result = spawnSync('bash', [slmScript, ...args], {
+        stdio: 'inherit'
+    });
+}
+
+// Exit with the same code as the child process
+process.exit(result.status || 0);

package/bin/slm.bat

@@ -0,0 +1,195 @@
+@echo off
+REM SuperLocalMemory V2 - Windows CLI Wrapper
+REM Copyright (c) 2026 Varun Pratap Bhardwaj
+REM Licensed under MIT License
+REM Repository: https://github.com/varun369/SuperLocalMemoryV2
+REM
+REM ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
+
+setlocal enabledelayedexpansion
+
+REM Determine installation location
+if exist "%USERPROFILE%\.claude-memory\memory_store_v2.py" (
+    set INSTALL_DIR=%USERPROFILE%\.claude-memory
+) else if exist "%~dp0..\src\memory_store_v2.py" (
+    set INSTALL_DIR=%~dp0..\src
+) else (
+    echo ERROR: SuperLocalMemory installation not found.
+    echo.
+    echo Expected locations:
+    echo   - %USERPROFILE%\.claude-memory\memory_store_v2.py
+    echo   - %~dp0..\src\memory_store_v2.py
+    echo.
+    echo Run install.ps1 to install SuperLocalMemory V2.
+    exit /b 1
+)
+
+REM Check Python availability
+where python >nul 2>&1
+if %ERRORLEVEL% EQU 0 (
+    set PYTHON_CMD=python
+    goto :python_found
+)
+
+where python3 >nul 2>&1
+if %ERRORLEVEL% EQU 0 (
+    set PYTHON_CMD=python3
+    goto :python_found
+)
+
+echo ERROR: Python not found in PATH.
+echo.
+echo Please install Python 3.8 or higher from:
+echo   https://www.python.org/downloads/
+echo.
+echo Make sure to check "Add Python to PATH" during installation.
+exit /b 1
+
+:python_found
+
+REM Parse command
+if "%1"=="" (
+    echo SuperLocalMemory V2.1.0 - Universal AI Memory System
+    echo.
+    echo Usage: slm [command] [options]
+    echo.
+    echo Commands:
+    echo   remember [content]     Store a new memory
+    echo   recall [query]         Search memories
+    echo   list-recent [N]        List recent memories
+    echo   status                 Show system status
+    echo   build-graph            Rebuild knowledge graph
+    echo   switch-profile [name]  Switch memory profile
+    echo   help                   Show this help
+    echo.
+    echo Examples:
+    echo   slm remember "React hooks for state management" --tags frontend,react
+    echo   slm recall "authentication patterns"
+    echo   slm list-recent 20
+    echo   slm status
+    echo.
+    echo Documentation: https://github.com/varun369/SuperLocalMemoryV2/wiki
+    exit /b 0
+)
+
+REM Handle special commands
+if /i "%1"=="help" goto :show_help
+if /i "%1"=="--help" goto :show_help
+if /i "%1"=="-h" goto :show_help
+if /i "%1"=="version" goto :show_version
+if /i "%1"=="--version" goto :show_version
+if /i "%1"=="-v" goto :show_version
+
+REM Route commands to appropriate Python module
+if /i "%1"=="remember" goto :remember
+if /i "%1"=="recall" goto :recall
+if /i "%1"=="list-recent" goto :list_recent
+if /i "%1"=="list" goto :list_recent
+if /i "%1"=="status" goto :status
+if /i "%1"=="stats" goto :status
+if /i "%1"=="build-graph" goto :build_graph
+if /i "%1"=="switch-profile" goto :switch_profile
+if /i "%1"=="profile" goto :switch_profile
+
+echo ERROR: Unknown command: %1
+echo.
+echo Run "slm help" for usage information.
+exit /b 1
+
+:remember
+shift
+%PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" add %*
+exit /b %ERRORLEVEL%
+
+:recall
+shift
+%PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" search %*
+exit /b %ERRORLEVEL%
+
+:list_recent
+shift
+if "%1"=="" (
+    %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" list 20
+) else (
+    %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" list %*
+)
+exit /b %ERRORLEVEL%
+
+:status
+%PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" stats
+exit /b %ERRORLEVEL%
+
+:build_graph
+if exist "%INSTALL_DIR%\graph_engine.py" (
+    %PYTHON_CMD% "%INSTALL_DIR%\graph_engine.py" build
+) else (
+    echo ERROR: graph_engine.py not found.
+    exit /b 1
+)
+exit /b %ERRORLEVEL%
+
+:switch_profile
+shift
+if exist "%INSTALL_DIR%\memory-profiles.py" (
+    if "%1"=="" (
+        %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" list
+    ) else if "%1"=="--list" (
+        %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" list
+    ) else (
+        %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" switch %*
+    )
+) else (
+    echo ERROR: memory-profiles.py not found.
+    exit /b 1
+)
+exit /b %ERRORLEVEL%
+
+:show_help
+echo SuperLocalMemory V2.1.0 - Universal AI Memory System
+echo.
+echo Usage: slm [command] [options]
+echo.
+echo Commands:
+echo   remember [content]              Store a new memory
+echo     Options:
+echo       --tags TAG1,TAG2            Add tags
+echo       --project NAME              Set project
+echo       --importance N              Set importance (1-10)
+echo.
+echo   recall [query]                  Search memories
+echo     Options:
+echo       --limit N                   Limit results (default: 10)
+echo       --tags TAG1,TAG2            Filter by tags
+echo       --project NAME              Filter by project
+echo.
+echo   list-recent [N]                 List N most recent memories
+echo   status                          Show system statistics
+echo   build-graph                     Rebuild knowledge graph
+echo   switch-profile [name]           Switch memory profile
+echo     Options:
+echo       --list                      List all profiles
+echo.
+echo   help                            Show this help
+echo   version                         Show version
+echo.
+echo Examples:
+echo   slm remember "React hooks for state management" --tags frontend,react
+echo   slm recall "authentication patterns" --limit 5
+echo   slm list-recent 20
+echo   slm status
+echo   slm build-graph
+echo   slm switch-profile work
+echo.
+echo Installation: %INSTALL_DIR%
+echo Database: %USERPROFILE%\.claude-memory\memory.db
+echo.
+echo Documentation: https://github.com/varun369/SuperLocalMemoryV2/wiki
+echo Report issues: https://github.com/varun369/SuperLocalMemoryV2/issues
+exit /b 0
+
+:show_version
+echo SuperLocalMemory V2.1.0-universal
+echo Copyright (c) 2026 Varun Pratap Bhardwaj
+echo Licensed under MIT License
+echo Repository: https://github.com/varun369/SuperLocalMemoryV2
+exit /b 0

package/bin/slm.cmd

@@ -0,0 +1,10 @@
+@echo off
+REM SuperLocalMemory V2 - Windows CLI Wrapper (CMD variant)
+REM Copyright (c) 2026 Varun Pratap Bhardwaj
+REM Licensed under MIT License
+REM
+REM This is a simplified wrapper that calls slm.bat
+REM Exists for compatibility with systems that prefer .cmd over .bat
+
+call "%~dp0slm.bat" %*
+exit /b %ERRORLEVEL%

package/bin/superlocalmemoryv2:list

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

package/bin/superlocalmemoryv2:profile

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

package/bin/superlocalmemoryv2:recall

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

package/bin/superlocalmemoryv2:remember

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

package/bin/superlocalmemoryv2:reset

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

package/bin/superlocalmemoryv2:status

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

package/completions/slm.bash

@@ -0,0 +1,58 @@
+# Bash completion for slm command
+# Source this file or copy to /usr/local/etc/bash_completion.d/
+
+_slm_completions() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+
+    # Main commands
+    local main_commands="remember recall list status context profile graph patterns reset help version"
+
+    # Profile subcommands
+    local profile_commands="list create switch delete current"
+
+    # Graph subcommands
+    local graph_commands="build stats"
+
+    # Pattern subcommands
+    local pattern_commands="update list context"
+
+    # Reset subcommands
+    local reset_commands="soft hard layer"
+
+    if [[ ${COMP_CWORD} -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "${main_commands}" -- ${cur}) )
+        return 0
+    fi
+
+    case "${COMP_WORDS[1]}" in
+        profile)
+            if [[ ${COMP_CWORD} -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "${profile_commands}" -- ${cur}) )
+            fi
+            return 0
+            ;;
+        graph)
+            if [[ ${COMP_CWORD} -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "${graph_commands}" -- ${cur}) )
+            fi
+            return 0
+            ;;
+        patterns)
+            if [[ ${COMP_CWORD} -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "${pattern_commands}" -- ${cur}) )
+            fi
+            return 0
+            ;;
+        reset)
+            if [[ ${COMP_CWORD} -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "${reset_commands}" -- ${cur}) )
+            fi
+            return 0
+            ;;
+    esac
+}
+
+complete -F _slm_completions slm

package/completions/slm.zsh

@@ -0,0 +1,76 @@
+#compdef slm
+# Zsh completion for slm command
+# Copy to a directory in $fpath or source directly
+
+_slm() {
+    local -a main_commands profile_commands graph_commands pattern_commands reset_commands
+
+    main_commands=(
+        'remember:Save content to memory'
+        'recall:Search memories'
+        'list:List recent memories'
+        'status:System status'
+        'context:Project context'
+        'profile:Manage profiles'
+        'graph:Knowledge graph operations'
+        'patterns:Pattern learning'
+        'reset:Reset operations'
+        'help:Show help'
+        'version:Show version'
+    )
+
+    profile_commands=(
+        'list:List all profiles'
+        'create:Create new profile'
+        'switch:Switch to profile'
+        'delete:Delete profile'
+        'current:Show current profile'
+    )
+
+    graph_commands=(
+        'build:Build/rebuild knowledge graph'
+        'stats:Show graph statistics'
+    )
+
+    pattern_commands=(
+        'update:Learn patterns from memories'
+        'list:List learned patterns'
+        'context:Get coding identity context'
+    )
+
+    reset_commands=(
+        'soft:Soft reset (clear memories)'
+        'hard:Hard reset (nuclear option)'
+        'layer:Layer-specific reset'
+    )
+
+    if (( CURRENT == 2 )); then
+        _describe 'slm commands' main_commands
+        return
+    fi
+
+    case "$words[2]" in
+        profile)
+            if (( CURRENT == 3 )); then
+                _describe 'profile commands' profile_commands
+            fi
+            ;;
+        graph)
+            if (( CURRENT == 3 )); then
+                _describe 'graph commands' graph_commands
+            fi
+            ;;
+        patterns)
+            if (( CURRENT == 3 )); then
+                _describe 'pattern commands' pattern_commands
+            fi
+            ;;
+        reset)
+            if (( CURRENT == 3 )); then
+                _describe 'reset commands' reset_commands
+            fi
+            ;;
+    esac
+}
+
+_slm "$@"

package/configs/antigravity-mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "superlocalmemory-v2": {
+      "command": "python3",
+      "args": ["{{INSTALL_DIR}}/mcp_server.py"],
+      "env": {
+        "PYTHONPATH": "{{INSTALL_DIR}}"
+      },
+      "cwd": "{{INSTALL_DIR}}",
+      "description": "SuperLocalMemory V2 - 100% local memory system"
+    }
+  }
+}

package/configs/chatgpt-desktop-mcp.json

@@ -0,0 +1,7 @@
+{
+  "_README": "ChatGPT requires HTTP transport, not stdio. See docs/MCP-MANUAL-SETUP.md#chatgpt-desktop-app",
+  "_step1": "Run: slm serve --port 8001",
+  "_step2": "Expose via: ngrok http 8001 (or cloudflared tunnel)",
+  "_step3": "Add the HTTPS URL to ChatGPT -> Settings -> Apps & Connectors -> Developer Mode",
+  "_note": "100% local - your MCP server runs on YOUR machine. The tunnel just makes it reachable."
+}

package/configs/claude-desktop-mcp.json

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