superlocalmemory 3.0.10 → 3.0.12

package/docs/v2-archive/RESET-GUIDE.md

@@ -19,7 +19,7 @@ The reset utility provides safe ways to clear and restart your memory system.
 **Use when:** You want to start fresh but keep the system installed
 
 ```bash
-python ~/.claude-memory/memory-reset.py soft
+python ~/.superlocalmemory/memory-reset.py soft
 ```
 
 ---
@@ -34,7 +34,7 @@ python ~/.claude-memory/memory-reset.py soft
 **Use when:** You want completely fresh V2 database
 
 ```bash
-python ~/.claude-memory/memory-reset.py hard --confirm
+python ~/.superlocalmemory/memory-reset.py hard --confirm
 ```
 
 **⚠️ Requires `--confirm` flag for safety**
@@ -54,10 +54,10 @@ python ~/.claude-memory/memory-reset.py hard --confirm
 
 ```bash
 # Clear only graph and patterns
-python ~/.claude-memory/memory-reset.py layer --layers graph patterns
+python ~/.superlocalmemory/memory-reset.py layer --layers graph patterns
 
 # Clear only graph
-python ~/.claude-memory/memory-reset.py layer --layers graph
+python ~/.superlocalmemory/memory-reset.py layer --layers graph
 ```
 
 ---
@@ -68,7 +68,7 @@ python ~/.claude-memory/memory-reset.py layer --layers graph
 - View row counts and database size
 
 ```bash
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 ```
 
 ---
@@ -78,12 +78,12 @@ python ~/.claude-memory/memory-reset.py status
 ### Automatic Backups
 Every reset operation creates a timestamped backup:
 ```
-~/.claude-memory/backups/pre-reset-YYYYMMDD-HHMMSS.db
+~/.superlocalmemory/backups/pre-reset-YYYYMMDD-HHMMSS.db
 ```
 
 **Skip backup** (not recommended):
 ```bash
-python ~/.claude-memory/memory-reset.py soft --no-backup
+python ~/.superlocalmemory/memory-reset.py soft --no-backup
 ```
 
 ### Confirmation Prompts
@@ -95,11 +95,11 @@ python ~/.claude-memory/memory-reset.py soft --no-backup
 If you reset by mistake:
 ```bash
 # Find latest backup
-ls -lt ~/.claude-memory/backups/
+ls -lt ~/.superlocalmemory/backups/
 
 # Restore backup
-cp ~/.claude-memory/backups/pre-reset-20260205-143000.db \
-   ~/.claude-memory/memory.db
+cp ~/.superlocalmemory/backups/pre-reset-20260205-143000.db \
+   ~/.superlocalmemory/memory.db
 ```
 
 ---
@@ -109,15 +109,15 @@ cp ~/.claude-memory/backups/pre-reset-20260205-143000.db \
 ### Scenario 1: "I want to start completely fresh"
 ```bash
 # Check current state
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 
 # Hard reset (creates backup automatically)
-python ~/.claude-memory/memory-reset.py hard --confirm
+python ~/.superlocalmemory/memory-reset.py hard --confirm
 
 # Type: DELETE EVERYTHING
 
 # Verify clean state
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 ```
 
 **Result:** Fresh V2 database, ready for new memories
@@ -127,12 +127,12 @@ python ~/.claude-memory/memory-reset.py status
 ### Scenario 2: "I want to clear memories but keep structure"
 ```bash
 # Soft reset
-python ~/.claude-memory/memory-reset.py soft
+python ~/.superlocalmemory/memory-reset.py soft
 
 # Type: yes
 
 # Add new memories
-python ~/.claude-memory/memory_store.py add "First new memory"
+python ~/.superlocalmemory/memory_store.py add "First new memory"
 ```
 
 **Result:** Empty database with V2 schema intact
@@ -142,10 +142,10 @@ python ~/.claude-memory/memory_store.py add "First new memory"
 ### Scenario 3: "My graph is corrupted, rebuild it"
 ```bash
 # Clear only graph layer
-python ~/.claude-memory/memory-reset.py layer --layers graph
+python ~/.superlocalmemory/memory-reset.py layer --layers graph
 
 # Rebuild graph from existing memories
-~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py build
+~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py build
 ```
 
 **Result:** Graph rebuilt, memories and patterns untouched
@@ -155,10 +155,10 @@ python ~/.claude-memory/memory-reset.py layer --layers graph
 ### Scenario 4: "Patterns learned wrong, reset them"
 ```bash
 # Clear only patterns layer
-python ~/.claude-memory/memory-reset.py layer --layers patterns
+python ~/.superlocalmemory/memory-reset.py layer --layers patterns
 
 # Re-learn patterns
-~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py update
+~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py update
 ```
 
 **Result:** Patterns re-learned, memories and graph untouched
@@ -203,7 +203,7 @@ python ~/.claude-memory/memory-reset.py layer --layers patterns
 To completely remove SuperLocalMemory V2:
 ```bash
 # Manual uninstall (use with caution)
-rm -rf ~/.claude-memory/
+rm -rf ~/.superlocalmemory/
 ```
 
 **⚠️ This deletes everything including backups!**
@@ -211,8 +211,8 @@ rm -rf ~/.claude-memory/
 Better approach - keep documentation:
 ```bash
 # Keep docs, delete data
-rm ~/.claude-memory/memory.db
-rm -rf ~/.claude-memory/venv/
+rm ~/.superlocalmemory/memory.db
+rm -rf ~/.superlocalmemory/venv/
 ```
 
 ---
@@ -222,7 +222,7 @@ rm -rf ~/.claude-memory/venv/
 ### After Soft Reset:
 ```bash
 # Check tables exist but are empty
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 
 # Should show:
 # Memories: 0 rows
@@ -234,7 +234,7 @@ python ~/.claude-memory/memory-reset.py status
 ### After Hard Reset:
 ```bash
 # Check fresh V2 schema
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 
 # Should show:
 # All tables present
@@ -245,7 +245,7 @@ python ~/.claude-memory/memory-reset.py status
 ### After Layer Reset:
 ```bash
 # Check specific layer cleared
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 
 # Example after clearing graph:
 # Graph Nodes: 0 rows
@@ -260,7 +260,7 @@ python ~/.claude-memory/memory-reset.py status
 
 1. **Always check status first:**
    ```bash
-   python ~/.claude-memory/memory-reset.py status
+   python ~/.superlocalmemory/memory-reset.py status
    ```
 
 2. **Use layer reset when possible:**
@@ -289,24 +289,24 @@ python ~/.claude-memory/memory-reset.py status
 - Run hard reset again to reinitialize
 
 **Before any reset:**
-- Check: `ls -la ~/.claude-memory/memory.db`
+- Check: `ls -la ~/.superlocalmemory/memory.db`
 - Database may have been moved/deleted
 
 ### "Permission denied"
 ```bash
 # Make script executable
-chmod +x ~/.claude-memory/memory-reset.py
+chmod +x ~/.superlocalmemory/memory-reset.py
 
 # Or run with python
-python ~/.claude-memory/memory-reset.py status
+python ~/.superlocalmemory/memory-reset.py status
 ```
 
 ### "Backup failed"
 - Check disk space: `df -h`
-- Check permissions: `ls -la ~/.claude-memory/`
+- Check permissions: `ls -la ~/.superlocalmemory/`
 - Manually create backup:
   ```bash
-  cp ~/.claude-memory/memory.db ~/.claude-memory/backups/manual-backup.db
+  cp ~/.superlocalmemory/memory.db ~/.superlocalmemory/backups/manual-backup.db
   ```
 
 ### "Hard reset didn't reinitialize"
@@ -314,7 +314,7 @@ python ~/.claude-memory/memory-reset.py status
 - Check for errors in output
 - Manually verify schema:
   ```bash
-  sqlite3 ~/.claude-memory/memory.db ".tables"
+  sqlite3 ~/.superlocalmemory/memory.db ".tables"
   ```
 
 ---
@@ -325,16 +325,16 @@ python ~/.claude-memory/memory-reset.py status
 1. **Stop immediately** - Don't run more commands
 2. **Check backups:**
    ```bash
-   ls -lt ~/.claude-memory/backups/
+   ls -lt ~/.superlocalmemory/backups/
    ```
 3. **Restore latest backup:**
    ```bash
-   cp ~/.claude-memory/backups/pre-reset-<timestamp>.db \
-      ~/.claude-memory/memory.db
+   cp ~/.superlocalmemory/backups/pre-reset-<timestamp>.db \
+      ~/.superlocalmemory/memory.db
    ```
 4. **Verify restoration:**
    ```bash
-   python ~/.claude-memory/memory-reset.py status
+   python ~/.superlocalmemory/memory-reset.py status
    ```
 
 ---

package/docs/v2-archive/UI-SERVER.md

@@ -49,7 +49,7 @@ The UI server requires an existing memory database. If you haven't created one y
 # Create demo database with sample data
 python create_demo_db.py
 
-# OR use your existing ~/.claude-memory/memory.db
+# OR use your existing ~/.superlocalmemory/memory.db
 ```
 
 ### 3. Start the Server
@@ -136,7 +136,7 @@ curl "http://localhost:8765/api/stats"
 
 By default, the server uses:
 - Demo mode: `demo-memory.db` in the repo
-- Production: `~/.claude-memory/memory.db`
+- Production: `~/.superlocalmemory/memory.db`
 
 To change the database path, modify `DB_PATH` in `ui_server.py`.
 

package/docs/v2-archive/UNIVERSAL-INTEGRATION.md

@@ -169,7 +169,7 @@ Continue's AI can also call memory tools directly.
 slashCommands:
   - name: "slm-remember"
     description: "Save to SuperLocalMemory"
-    run: "~/.claude-memory/bin/superlocalmemoryv2-remember \"{{input}}\""
+    run: "~/.superlocalmemory/bin/superlocalmemoryv2-remember \"{{input}}\""
 
 # For MCP tools
 contextProviders:
@@ -431,12 +431,12 @@ source ~/.zshrc  # or ~/.bashrc
 
 **Start MCP server manually:**
 ```bash
-python3 ~/.claude-memory/mcp_server.py
+python3 ~/.superlocalmemory/mcp_server.py
 ```
 
 **Start with HTTP transport:**
 ```bash
-python3 ~/.claude-memory/mcp_server.py --transport http --port 8001
+python3 ~/.superlocalmemory/mcp_server.py --transport http --port 8001
 ```
 
 **Check MCP server tools:**

package/docs/v2-archive/V2.2.0-OPTIONAL-SEARCH.md

@@ -251,7 +251,7 @@ engine.clear_cache()
 Cache settings:
 - **Max size:** 10,000 entries
 - **Eviction:** LRU (Least Recently Used)
-- **Persistence:** Saved to `~/.claude-memory/embedding_cache.json`
+- **Persistence:** Saved to `~/.superlocalmemory/embedding_cache.json`
 
 ### Security & Limits
 
@@ -430,7 +430,7 @@ engine = EmbeddingEngine(device='cpu')
 
 **Solution:**
 Models are cached locally after first download:
-- Location: `~/.claude-memory/models/`
+- Location: `~/.superlocalmemory/models/`
 - Size: 80MB (all-MiniLM-L6-v2)
 - Subsequent loads: <1 second
 

package/ide/configs/antigravity-mcp.json

@@ -1,13 +1,11 @@
 {
   "mcpServers": {
     "superlocalmemory": {
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      },
-      "cwd": "{{INSTALL_DIR}}",
+      "command": "slm",
+      "args": [
+        "mcp"
+      ],
       "description": "SuperLocalMemory V3 - 100% local memory system"
     }
   }
-}
+}

package/ide/configs/claude-desktop-mcp.json

@@ -1,15 +1,11 @@
 {
   "mcpServers": {
     "superlocalmemory": {
-      "command": "python3",
+      "command": "slm",
       "args": [
-        "-m", "superlocalmemory.mcp.server"
+        "mcp"
       ],
-      "cwd": "{{INSTALL_DIR}}",
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      },
       "description": "SuperLocalMemory V3 - 100% local memory system for AI assistants"
     }
   }
-}
+}

package/ide/configs/codex-mcp.toml

@@ -6,8 +6,6 @@
 # Manual: Copy this to ~/.codex/config.toml
 
 [mcp_servers.superlocalmemory]
-command = "python3"
-args = ["-m", "superlocalmemory.mcp.server"]
+command = "slm"
+args = ["mcp"]
 
-[mcp_servers.superlocalmemory.env]
-PYTHONPATH = "{{INSTALL_DIR}}"

package/ide/configs/continue-mcp.yaml

@@ -5,10 +5,9 @@ contextProviders:
   - name: mcp
     params:
       serverName: "superlocalmemory"
-      command: "python3"
+      command: "slm"
       args:
-        - "-m"
-        - "superlocalmemory.mcp.server"
+        - "mcp"
       description: "SuperLocalMemory V3 - Search your memory system"
 
 # You can also use Continue's slash commands with SuperLocalMemory

package/ide/configs/cursor-mcp.json

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

package/ide/configs/gemini-cli-mcp.json

@@ -1,11 +1,11 @@
 {
   "mcpServers": {
     "superlocalmemory": {
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      }
+      "command": "slm",
+      "args": [
+        "mcp"
+      ],
+      "description": "SuperLocalMemory V3"
     }
   }
-}
+}

package/ide/configs/jetbrains-mcp.json

@@ -1,11 +1,11 @@
 {
   "mcpServers": {
     "superlocalmemory": {
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      }
+      "command": "slm",
+      "args": [
+        "mcp"
+      ],
+      "description": "SuperLocalMemory V3"
     }
   }
-}
+}

package/ide/configs/opencode-mcp.json

@@ -1,12 +1,10 @@
 {
   "mcp": {
     "superlocalmemory": {
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      },
-      "cwd": "{{INSTALL_DIR}}"
+      "command": "slm",
+      "args": [
+        "mcp"
+      ]
     }
   }
-}
+}

package/ide/configs/perplexity-mcp.json

@@ -1,9 +1,9 @@
 {
   "superlocalmemory": {
-    "command": "python3",
-    "args": ["-m", "superlocalmemory.mcp.server"],
-    "env": {
-      "PYTHONPATH": "{{INSTALL_DIR}}"
-    }
+    "command": "slm",
+    "args": [
+      "mcp"
+    ],
+    "env": {}
   }
-}
+}

package/ide/configs/vscode-copilot-mcp.json

@@ -2,11 +2,10 @@
   "servers": {
     "superlocalmemory": {
       "type": "stdio",
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      }
+      "command": "slm",
+      "args": [
+        "mcp"
+      ]
     }
   }
-}
+}

package/ide/configs/windsurf-mcp.json

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

package/ide/configs/zed-mcp.json

@@ -2,11 +2,10 @@
   "context_servers": {
     "superlocalmemory": {
       "source": "custom",
-      "command": "python3",
-      "args": ["-m", "superlocalmemory.mcp.server"],
-      "env": {
-        "PYTHONPATH": "{{INSTALL_DIR}}"
-      }
+      "command": "slm",
+      "args": [
+        "mcp"
+      ]
     }
   }
-}
+}

package/ide/integrations/langchain/README.md

@@ -7,7 +7,7 @@ Every message stays on your machine in a SQLite database. No API keys, no subscr
 ## Prerequisites
 
 - Python 3.10+
-- [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory) installed (`~/.claude-memory/` must exist)
+- [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory) installed (`~/.superlocalmemory/` must exist)
 - `langchain-core >= 1.0.0`
 
 ## Installation
@@ -48,7 +48,7 @@ history.clear()
 
 ## Features
 
-- **Local-first storage** -- all data stays in `~/.claude-memory/memory.db`
+- **Local-first storage** -- all data stays in `~/.superlocalmemory/memory.db`
 - **Session isolation** -- each `session_id` is completely independent
 - **Full LangChain compatibility** -- implements `BaseChatMessageHistory`
 - **Persistent across restarts** -- SQLite-backed, survives process exit
@@ -75,7 +75,7 @@ assert len(coding.messages) == 1
 
 ## Custom Database Path
 
-By default the package uses `~/.claude-memory/memory.db`. You can point to a different database:
+By default the package uses `~/.superlocalmemory/memory.db`. You can point to a different database:
 
 ```python
 history = SuperLocalMemoryChatMessageHistory(

package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py

@@ -33,13 +33,13 @@ from langchain_core.messages import (
 # ---------------------------------------------------------------------------
 # MemoryStoreV2 import strategy
 # ---------------------------------------------------------------------------
-# SuperLocalMemory V2 installs to ~/.claude-memory/. We add that path so
+# SuperLocalMemory V2 installs to ~/.superlocalmemory/. We add that path so
 # the MemoryStoreV2 class can be imported. If SLM is not installed, we
 # raise a clear error at construction time (not import time) so the package
 # itself can still be imported for introspection.
 # ---------------------------------------------------------------------------
 
-_SLM_PATH = Path.home() / ".claude-memory"
+_SLM_PATH = Path.home() / ".superlocalmemory"
 _MemoryStoreV2 = None
 
 
@@ -54,7 +54,7 @@ def _ensure_slm_imported():
         sys.path.insert(0, slm_path_str)
 
     try:
-        from memory_store_v2 import MemoryStoreV2  # type: ignore[import-untyped]
+        from superlocalmemory.core.engine import MemoryEngine  # type: ignore[import-untyped]
 
         _MemoryStoreV2 = MemoryStoreV2
         return _MemoryStoreV2
@@ -62,7 +62,7 @@ def _ensure_slm_imported():
         raise ImportError(
             "SuperLocalMemory V2 is not installed. "
             "Run the installer from https://github.com/qualixar/superlocalmemory "
-            "or ensure ~/.claude-memory/memory_store_v2.py exists."
+            "or ensure ~/.superlocalmemory/is installed via npm/pip."
         ) from exc
 
 
@@ -117,7 +117,7 @@ class SuperLocalMemoryChatMessageHistory(BaseChatMessageHistory):
         different session IDs are completely isolated.
     db_path : str or None
         Path to the SQLite database file.  Defaults to
-        ``~/.claude-memory/memory.db``.
+        ``~/.superlocalmemory/memory.db``.
     """
 
     # Tag prefix used to isolate LangChain session messages inside SLM.

package/ide/integrations/langchain/pyproject.toml

@@ -30,9 +30,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/varun369/SuperLocalMemoryV2"
+Homepage = "https://github.com/qualixar/superlocalmemory"
 Documentation = "https://superlocalmemory.com/"
-Repository = "https://github.com/varun369/SuperLocalMemoryV2"
+Repository = "https://github.com/qualixar/superlocalmemory"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

package/ide/integrations/llamaindex/README.md

@@ -5,7 +5,7 @@ A LlamaIndex `BaseChatStore` implementation backed by [SuperLocalMemory V2](http
 ## Prerequisites
 
 - Python 3.9+
-- SuperLocalMemory V2 installed (`~/.claude-memory/` must exist)
+- SuperLocalMemory V2 installed (`~/.superlocalmemory/` must exist)
 
 ```bash
 # Install SuperLocalMemory V2 (one-time)
@@ -51,7 +51,7 @@ chat_store.delete_messages("session-1")
 
 ## Features
 
-- **100% Local** — All data stored in SQLite at `~/.claude-memory/memory.db`
+- **100% Local** — All data stored in SQLite at `~/.superlocalmemory/memory.db`
 - **Zero Cloud** — No API keys, no subscriptions, no data leaves your machine
 - **Shared Memory** — Chat history is accessible from Claude, Cursor, Windsurf, and 16+ other AI tools via SuperLocalMemory
 - **Session Isolation** — Each chat key is cleanly isolated using SLM tags

package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py

@@ -25,7 +25,7 @@ from llama_index.core.storage.chat_store.base import BaseChatStore
 # ---------------------------------------------------------------------------
 # Locate and import SuperLocalMemory V2's MemoryStoreV2
 # ---------------------------------------------------------------------------
-_SLM_PATH = Path.home() / ".claude-memory"
+_SLM_PATH = Path.home() / ".superlocalmemory"
 if str(_SLM_PATH) not in sys.path:
     sys.path.insert(0, str(_SLM_PATH))
 
@@ -35,7 +35,7 @@ if _SLM_SRC_PATH.exists() and str(_SLM_SRC_PATH) not in sys.path:
     sys.path.insert(0, str(_SLM_SRC_PATH))
 
 try:
-    from memory_store_v2 import MemoryStoreV2
+    from superlocalmemory.core.engine import MemoryEngine
 except ImportError as exc:
     raise ImportError(
         "SuperLocalMemory V2 is not installed. "
@@ -139,7 +139,7 @@ class SuperLocalMemoryChatStore(BaseChatStore):
 
     Args:
         db_path: Optional path to the SQLite database file.
-                 Defaults to ``~/.claude-memory/memory.db``.
+                 Defaults to ``~/.superlocalmemory/memory.db``.
     """
 
     # Pydantic fields ---------------------------------------------------
@@ -154,7 +154,7 @@ class SuperLocalMemoryChatStore(BaseChatStore):
 
         Args:
             db_path: Optional path to the SLM SQLite database.
-                     If None, uses the default ``~/.claude-memory/memory.db``.
+                     If None, uses the default ``~/.superlocalmemory/memory.db``.
         """
         super().__init__(**kwargs)
         self._db_path = db_path