superlocalmemory 3.0.11 → 3.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +15 -0
  2. package/bin/slm.bat +14 -184
  3. package/bin/slm.cmd +2 -7
  4. package/docs/api-reference.md +1 -1
  5. package/docs/migration-from-v2.md +4 -4
  6. package/docs/v2-archive/ARCHITECTURE.md +1 -1
  7. package/docs/v2-archive/CLI-COMMANDS-REFERENCE.md +35 -35
  8. package/docs/v2-archive/COMPRESSION-README.md +23 -23
  9. package/docs/v2-archive/FRAMEWORK-INTEGRATIONS.md +2 -2
  10. package/docs/v2-archive/MCP-MANUAL-SETUP.md +10 -10
  11. package/docs/v2-archive/MCP-TROUBLESHOOTING.md +29 -29
  12. package/docs/v2-archive/PATTERN-LEARNING.md +2 -2
  13. package/docs/v2-archive/PROFILES-GUIDE.md +52 -52
  14. package/docs/v2-archive/RESET-GUIDE.md +36 -36
  15. package/docs/v2-archive/UI-SERVER.md +2 -2
  16. package/docs/v2-archive/UNIVERSAL-INTEGRATION.md +3 -3
  17. package/docs/v2-archive/V2.2.0-OPTIONAL-SEARCH.md +2 -2
  18. package/ide/configs/antigravity-mcp.json +5 -7
  19. package/ide/configs/claude-desktop-mcp.json +3 -7
  20. package/ide/configs/codex-mcp.toml +2 -4
  21. package/ide/configs/continue-mcp.yaml +2 -3
  22. package/ide/configs/cursor-mcp.json +3 -7
  23. package/ide/configs/gemini-cli-mcp.json +6 -6
  24. package/ide/configs/jetbrains-mcp.json +6 -6
  25. package/ide/configs/opencode-mcp.json +5 -7
  26. package/ide/configs/perplexity-mcp.json +6 -6
  27. package/ide/configs/vscode-copilot-mcp.json +5 -6
  28. package/ide/configs/windsurf-mcp.json +3 -8
  29. package/ide/configs/zed-mcp.json +5 -6
  30. package/ide/integrations/langchain/README.md +3 -3
  31. package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py +5 -5
  32. package/ide/integrations/langchain/pyproject.toml +2 -2
  33. package/ide/integrations/llamaindex/README.md +2 -2
  34. package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py +4 -4
  35. package/ide/integrations/llamaindex/pyproject.toml +2 -2
  36. package/ide/skills/slm-show-patterns/SKILL.md +1 -1
  37. package/package.json +1 -1
  38. package/pyproject.toml +1 -1
  39. package/scripts/build-dmg.sh +8 -8
  40. package/scripts/install-skills.ps1 +2 -2
  41. package/scripts/install-skills.sh +3 -3
  42. package/scripts/install.ps1 +13 -13
  43. package/scripts/install.sh +9 -9
  44. package/scripts/preuninstall.js +1 -1
  45. package/scripts/sync-wiki.ps1 +3 -3
  46. package/scripts/sync-wiki.sh +3 -3
  47. package/scripts/test-dmg.sh +1 -1
  48. package/scripts/test-npm-package.ps1 +1 -1
  49. package/scripts/test-npm-package.sh +1 -1
  50. package/scripts/verify-install.ps1 +1 -1
  51. package/scripts/verify-install.sh +4 -4
  52. package/scripts/verify-v27.ps1 +3 -3
  53. package/scripts/verify-v27.sh +3 -3
  54. package/src/superlocalmemory/cli/commands.py +8 -0
  55. package/src/superlocalmemory/cli/main.py +3 -0
  56. package/src/superlocalmemory/cli/post_install.py +1 -1
  57. package/src/superlocalmemory/hooks/ide_connector.py +2 -2
  58. package/src/superlocalmemory.egg-info/PKG-INFO +16 -1
package/README.md CHANGED
@@ -178,6 +178,21 @@ Add to your IDE's MCP config:
178
178
  slm dashboard # Opens at http://localhost:8765
179
179
  ```
180
180
 
181
+ <details open>
182
+ <summary><strong>Dashboard Screenshots</strong> (click to collapse)</summary>
183
+ <p align="center"><img src="docs/screenshots/01-dashboard-main.png" alt="Dashboard" width="600"/></p>
184
+ <p align="center">
185
+ <img src="docs/screenshots/02-knowledge-graph.png" alt="Graph" width="190"/>
186
+ <img src="docs/screenshots/03-math-health.png" alt="Math" width="190"/>
187
+ <img src="docs/screenshots/05-trust-dashboard.png" alt="Trust" width="190"/>
188
+ </p>
189
+ <p align="center">
190
+ <img src="docs/screenshots/04-recall-lab.png" alt="Recall" width="190"/>
191
+ <img src="docs/screenshots/06-settings.png" alt="Settings" width="190"/>
192
+ <img src="docs/screenshots/07-memories-blurred.png" alt="Memories" width="190"/>
193
+ </p>
194
+ </details>
195
+
181
196
  The V3 dashboard provides real-time visibility into your memory system:
182
197
 
183
198
  - **Dashboard** — Mode switcher, health score, quick store/recall
package/bin/slm.bat CHANGED
@@ -1,197 +1,27 @@
1
1
  @echo off
2
- REM SuperLocalMemory V2 - Windows CLI Wrapper
3
- REM Copyright (c) 2026 Varun Pratap Bhardwaj
2
+ REM SuperLocalMemory V3 - Windows CLI Wrapper
3
+ REM Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
4
4
  REM Licensed under MIT License
5
- REM Repository: https://github.com/varun369/SuperLocalMemoryV2
6
- REM
7
- REM ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
5
+ REM Repository: https://github.com/qualixar/superlocalmemory
8
6
 
9
7
  setlocal enabledelayedexpansion
10
8
 
11
- REM Determine installation location
12
- if defined SL_MEMORY_PATH (
13
- set "INSTALL_DIR=%SL_MEMORY_PATH%"
14
- ) else if exist "%USERPROFILE%\.claude-memory\memory_store_v2.py" (
15
- set INSTALL_DIR=%USERPROFILE%\.claude-memory
16
- ) else if exist "%~dp0..\src\memory_store_v2.py" (
17
- set INSTALL_DIR=%~dp0..\src
18
- ) else (
19
- echo ERROR: SuperLocalMemory installation not found.
20
- echo.
21
- echo Expected locations:
22
- echo - %USERPROFILE%\.claude-memory\memory_store_v2.py
23
- echo - %~dp0..\src\memory_store_v2.py
24
- echo.
25
- echo Run install.ps1 to install SuperLocalMemory V2.
26
- exit /b 1
27
- )
28
-
29
- REM Check Python availability
30
- where python >nul 2>&1
31
- if %ERRORLEVEL% EQU 0 (
32
- set PYTHON_CMD=python
33
- goto :python_found
34
- )
35
-
36
- where python3 >nul 2>&1
9
+ REM Find Python 3
10
+ where python3 >/dev/null 2>&1
37
11
  if %ERRORLEVEL% EQU 0 (
38
12
  set PYTHON_CMD=python3
39
- goto :python_found
13
+ goto :run
40
14
  )
41
-
42
- echo ERROR: Python not found in PATH.
43
- echo.
44
- echo Please install Python 3.8 or higher from:
45
- echo https://www.python.org/downloads/
46
- echo.
47
- echo Make sure to check "Add Python to PATH" during installation.
48
- exit /b 1
49
-
50
- :python_found
51
-
52
- REM Parse command
53
- if "%1"=="" (
54
- echo SuperLocalMemory - Universal AI Memory System
55
- echo.
56
- echo Usage: slm [command] [options]
57
- echo.
58
- echo Commands:
59
- echo remember [content] Store a new memory
60
- echo recall [query] Search memories
61
- echo list-recent [N] List recent memories
62
- echo status Show system status
63
- echo build-graph Rebuild knowledge graph
64
- echo switch-profile [name] Switch memory profile
65
- echo help Show this help
66
- echo.
67
- echo Examples:
68
- echo slm remember "React hooks for state management" --tags frontend,react
69
- echo slm recall "authentication patterns"
70
- echo slm list-recent 20
71
- echo slm status
72
- echo.
73
- echo Documentation: https://github.com/varun369/SuperLocalMemoryV2/wiki
74
- exit /b 0
15
+ where python >/dev/null 2>&1
16
+ if %ERRORLEVEL% EQU 0 (
17
+ set PYTHON_CMD=python
18
+ goto :run
75
19
  )
76
20
 
77
- REM Handle special commands
78
- if /i "%1"=="help" goto :show_help
79
- if /i "%1"=="--help" goto :show_help
80
- if /i "%1"=="-h" goto :show_help
81
- if /i "%1"=="version" goto :show_version
82
- if /i "%1"=="--version" goto :show_version
83
- if /i "%1"=="-v" goto :show_version
84
-
85
- REM Route commands to appropriate Python module
86
- if /i "%1"=="remember" goto :remember
87
- if /i "%1"=="recall" goto :recall
88
- if /i "%1"=="list-recent" goto :list_recent
89
- if /i "%1"=="list" goto :list_recent
90
- if /i "%1"=="status" goto :status
91
- if /i "%1"=="stats" goto :status
92
- if /i "%1"=="build-graph" goto :build_graph
93
- if /i "%1"=="switch-profile" goto :switch_profile
94
- if /i "%1"=="profile" goto :switch_profile
95
-
96
- echo ERROR: Unknown command: %1
97
- echo.
98
- echo Run "slm help" for usage information.
21
+ echo Error: Python 3.11+ not found.
22
+ echo Install from: https://python.org/downloads/
99
23
  exit /b 1
100
24
 
101
- :remember
102
- shift
103
- %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" add %*
25
+ :run
26
+ %PYTHON_CMD% -m superlocalmemory.cli.main %*
104
27
  exit /b %ERRORLEVEL%
105
-
106
- :recall
107
- shift
108
- %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" search %*
109
- exit /b %ERRORLEVEL%
110
-
111
- :list_recent
112
- shift
113
- if "%1"=="" (
114
- %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" list 20
115
- ) else (
116
- %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" list %*
117
- )
118
- exit /b %ERRORLEVEL%
119
-
120
- :status
121
- %PYTHON_CMD% "%INSTALL_DIR%\memory_store_v2.py" stats
122
- exit /b %ERRORLEVEL%
123
-
124
- :build_graph
125
- if exist "%INSTALL_DIR%\graph_engine.py" (
126
- %PYTHON_CMD% "%INSTALL_DIR%\graph_engine.py" build
127
- ) else (
128
- echo ERROR: graph_engine.py not found.
129
- exit /b 1
130
- )
131
- exit /b %ERRORLEVEL%
132
-
133
- :switch_profile
134
- shift
135
- if exist "%INSTALL_DIR%\memory-profiles.py" (
136
- if "%1"=="" (
137
- %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" list
138
- ) else if "%1"=="--list" (
139
- %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" list
140
- ) else (
141
- %PYTHON_CMD% "%INSTALL_DIR%\memory-profiles.py" switch %*
142
- )
143
- ) else (
144
- echo ERROR: memory-profiles.py not found.
145
- exit /b 1
146
- )
147
- exit /b %ERRORLEVEL%
148
-
149
- :show_help
150
- echo SuperLocalMemory - Universal AI Memory System
151
- echo.
152
- echo Usage: slm [command] [options]
153
- echo.
154
- echo Commands:
155
- echo remember [content] Store a new memory
156
- echo Options:
157
- echo --tags TAG1,TAG2 Add tags
158
- echo --project NAME Set project
159
- echo --importance N Set importance (1-10)
160
- echo.
161
- echo recall [query] Search memories
162
- echo Options:
163
- echo --limit N Limit results (default: 10)
164
- echo --tags TAG1,TAG2 Filter by tags
165
- echo --project NAME Filter by project
166
- echo.
167
- echo list-recent [N] List N most recent memories
168
- echo status Show system statistics
169
- echo build-graph Rebuild knowledge graph
170
- echo switch-profile [name] Switch memory profile
171
- echo Options:
172
- echo --list List all profiles
173
- echo.
174
- echo help Show this help
175
- echo version Show version
176
- echo.
177
- echo Examples:
178
- echo slm remember "React hooks for state management" --tags frontend,react
179
- echo slm recall "authentication patterns" --limit 5
180
- echo slm list-recent 20
181
- echo slm status
182
- echo slm build-graph
183
- echo slm switch-profile work
184
- echo.
185
- echo Installation: %INSTALL_DIR%
186
- echo Database: %INSTALL_DIR%\memory.db
187
- echo.
188
- echo Documentation: https://github.com/varun369/SuperLocalMemoryV2/wiki
189
- echo Report issues: https://github.com/varun369/SuperLocalMemoryV2/issues
190
- exit /b 0
191
-
192
- :show_version
193
- echo SuperLocalMemory V2.8.3
194
- echo Copyright (c) 2026 Varun Pratap Bhardwaj
195
- echo Licensed under MIT License
196
- echo Repository: https://github.com/varun369/SuperLocalMemoryV2
197
- exit /b 0
package/bin/slm.cmd CHANGED
@@ -1,10 +1,5 @@
1
1
  @echo off
2
- REM SuperLocalMemory V2 - Windows CLI Wrapper (CMD variant)
3
- REM Copyright (c) 2026 Varun Pratap Bhardwaj
4
- REM Licensed under MIT License
5
- REM
6
- REM This is a simplified wrapper that calls slm.bat
7
- REM Exists for compatibility with systems that prefer .cmd over .bat
8
-
2
+ REM SuperLocalMemory V3 - Windows CLI (CMD variant)
3
+ REM Calls slm.bat for compatibility
9
4
  call "%~dp0slm.bat" %*
10
5
  exit /b %ERRORLEVEL%
@@ -9,7 +9,7 @@ Use SuperLocalMemory programmatically from Python. This is for developers buildi
9
9
  ## Installation
10
10
 
11
11
  ```bash
12
- pip install superlocalmemory
12
+ npm install -g superlocalmemory
13
13
  ```
14
14
 
15
15
  Or, if you installed via npm, the Python package is available at:
@@ -14,7 +14,7 @@ Upgrade from SuperLocalMemory V2 to V3. Zero data loss, one command, rollback av
14
14
  | **Modes** | One mode (cloud required for smart features) | Three modes: A (zero-cloud), B (local LLM), C (cloud LLM) |
15
15
  | **Math layer** | None | Fisher-Rao similarity, Sheaf consistency, Langevin lifecycle |
16
16
  | **Ingestion** | Basic text storage | 11-step pipeline: entities, facts, emotions, beliefs, graph, and more |
17
- | **Data directory** | `~/.claude-memory/` | `~/.superlocalmemory/` (symlink preserves old path) |
17
+ | **Data directory** | `~/.superlocalmemory/` | `~/.superlocalmemory/` (symlink preserves old path) |
18
18
  | **Consistency** | Manual | Automatic contradiction detection |
19
19
  | **Recall quality** | Good | Significantly better on complex queries (multi-hop, temporal) |
20
20
 
@@ -52,8 +52,8 @@ slm migrate
52
52
  The migration:
53
53
 
54
54
  1. Creates a full backup of your V2 database
55
- 2. Moves data from `~/.claude-memory/` to `~/.superlocalmemory/`
56
- 3. Creates a symlink (`~/.claude-memory/ -> ~/.superlocalmemory/`) so old IDE configs still work
55
+ 2. Moves data from `~/.superlocalmemory/` to `~/.superlocalmemory/`
56
+ 3. Creates a symlink (`~/.superlocalmemory/ -> ~/.superlocalmemory/`) so old IDE configs still work
57
57
  4. Extends the database schema with V3 tables (15 new tables)
58
58
  5. Re-indexes existing memories for 4-channel retrieval
59
59
  6. Sets Mode A as default (zero breaking changes)
@@ -125,7 +125,7 @@ If anything goes wrong, roll back within 30 days:
125
125
  slm migrate --rollback
126
126
  ```
127
127
 
128
- This restores your V2 database from the backup created during migration. The symlink is removed and the original `~/.claude-memory/` directory is restored.
128
+ This restores your V2 database from the backup created during migration. The symlink is removed and the original `~/.superlocalmemory/` directory is restored.
129
129
 
130
130
  **After 30 days:** The backup is automatically cleaned up. If you need to roll back after 30 days, restore from your own backups.
131
131
 
@@ -221,7 +221,7 @@ SuperLocalMemory V2 uses a hierarchical, additive architecture where each layer
221
221
  ┌─────────────────────────────────────────────────────────────────┐
222
222
  │ Layer 7: Universal Access │
223
223
  │ Three access methods: MCP Protocol, Skills, CLI │
224
- │ All share one database (~/.claude-memory/memory.db) │
224
+ │ All share one database (~/.superlocalmemory/memory.db) │
225
225
  │ Output: Unified access across 16+ IDEs and tools │
226
226
  └─────────────────────────────────────────────────────────────────┘
227
227
 
@@ -107,7 +107,7 @@ All original commands continue to work unchanged. Use these if you prefer explic
107
107
  ```bash
108
108
  superlocalmemoryv2-status
109
109
  # OR
110
- ~/.claude-memory/bin/superlocalmemoryv2-status
110
+ ~/.superlocalmemory/bin/superlocalmemoryv2-status
111
111
  ```
112
112
  Shows: total memories, graph stats, clusters, patterns, database size
113
113
 
@@ -121,7 +121,7 @@ Shows: total memories, graph stats, clusters, patterns, database size
121
121
  ```bash
122
122
  superlocalmemoryv2-profile list
123
123
  # OR
124
- ~/.claude-memory/bin/superlocalmemoryv2-profile list
124
+ ~/.superlocalmemory/bin/superlocalmemoryv2-profile list
125
125
  ```
126
126
  Shows all profiles with active marker (→)
127
127
 
@@ -129,7 +129,7 @@ Shows all profiles with active marker (→)
129
129
  ```bash
130
130
  superlocalmemoryv2-profile current
131
131
  # OR
132
- ~/.claude-memory/bin/superlocalmemoryv2-profile current
132
+ ~/.superlocalmemory/bin/superlocalmemoryv2-profile current
133
133
  ```
134
134
  Shows current profile details and memory count
135
135
 
@@ -173,7 +173,7 @@ superlocalmemoryv2-status
173
173
  ```bash
174
174
  superlocalmemoryv2-reset soft
175
175
  # OR
176
- ~/.claude-memory/bin/superlocalmemoryv2-reset soft
176
+ ~/.superlocalmemory/bin/superlocalmemoryv2-reset soft
177
177
  ```
178
178
  - Clears all memories from current profile
179
179
  - Clears graph, patterns, tree structure
@@ -185,7 +185,7 @@ superlocalmemoryv2-reset soft
185
185
  ```bash
186
186
  superlocalmemoryv2-reset hard --confirm
187
187
  # OR
188
- ~/.claude-memory/bin/superlocalmemoryv2-reset hard --confirm
188
+ ~/.superlocalmemory/bin/superlocalmemoryv2-reset hard --confirm
189
189
  ```
190
190
  - ⚠️ **NUCLEAR OPTION** ⚠️
191
191
  - Deletes entire database file
@@ -197,7 +197,7 @@ superlocalmemoryv2-reset hard --confirm
197
197
  ```bash
198
198
  superlocalmemoryv2-reset layer --layers graph patterns
199
199
  # OR
200
- ~/.claude-memory/bin/superlocalmemoryv2-reset layer --layers graph patterns
200
+ ~/.superlocalmemory/bin/superlocalmemoryv2-reset layer --layers graph patterns
201
201
  ```
202
202
  Available layers:
203
203
  - `graph` - Clear graph nodes, edges, clusters
@@ -213,25 +213,25 @@ Prompt: "Proceed with layer reset? (yes/no)"
213
213
 
214
214
  ### Build Knowledge Graph
215
215
  ```bash
216
- ~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py build
216
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py build
217
217
  ```
218
218
  Builds graph from all memories using TF-IDF + Leiden clustering
219
219
 
220
220
  ### Show Graph Statistics
221
221
  ```bash
222
- ~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py stats
222
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py stats
223
223
  ```
224
224
  Shows: nodes, edges, clusters with names and member counts
225
225
 
226
226
  ### Find Related Memories
227
227
  ```bash
228
- ~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py related --memory-id 5
228
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py related --memory-id 5
229
229
  ```
230
230
  Shows memories connected in the knowledge graph
231
231
 
232
232
  ### View Cluster Members
233
233
  ```bash
234
- ~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py cluster --cluster-id 1
234
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py cluster --cluster-id 1
235
235
  ```
236
236
  Lists all memories in a specific cluster
237
237
 
@@ -241,25 +241,25 @@ Lists all memories in a specific cluster
241
241
 
242
242
  ### Update Patterns
243
243
  ```bash
244
- ~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py update
244
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py update
245
245
  ```
246
246
  Analyzes all memories and learns new identity patterns
247
247
 
248
248
  ### List Learned Patterns
249
249
  ```bash
250
- ~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py list 0.1
250
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py list 0.1
251
251
  ```
252
252
  Shows patterns with confidence >= 0.1 (10%)
253
253
 
254
254
  ### Get Claude Context
255
255
  ```bash
256
- ~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py context 0.7
256
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py context 0.7
257
257
  ```
258
258
  Outputs patterns formatted for Claude with confidence >= 0.7 (70%)
259
259
 
260
260
  ### Show Pattern Statistics
261
261
  ```bash
262
- ~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py stats
262
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py stats
263
263
  ```
264
264
  Shows pattern count, avg confidence, types, categories
265
265
 
@@ -269,22 +269,22 @@ Shows pattern count, avg confidence, types, categories
269
269
 
270
270
  ### Add Memory
271
271
  ```bash
272
- python ~/.claude-memory/memory_store_v2.py add "content" --tags tag1,tag2
272
+ python ~/.superlocalmemory/memory_store_v2.py add "content" --tags tag1,tag2
273
273
  ```
274
274
 
275
275
  ### Search Memories
276
276
  ```bash
277
- python ~/.claude-memory/memory_store_v2.py search "query"
277
+ python ~/.superlocalmemory/memory_store_v2.py search "query"
278
278
  ```
279
279
 
280
280
  ### List Recent Memories
281
281
  ```bash
282
- python ~/.claude-memory/memory_store_v2.py list 20
282
+ python ~/.superlocalmemory/memory_store_v2.py list 20
283
283
  ```
284
284
 
285
285
  ### Get Stats
286
286
  ```bash
287
- python ~/.claude-memory/memory_store_v2.py stats
287
+ python ~/.superlocalmemory/memory_store_v2.py stats
288
288
  ```
289
289
 
290
290
  ---
@@ -296,11 +296,11 @@ Add to `~/.bashrc` or `~/.zshrc`:
296
296
 
297
297
  ```bash
298
298
  # SuperLocalMemory V2 aliases
299
- alias memory-status='~/.claude-memory/bin/memory-status'
300
- alias memory-reset='~/.claude-memory/bin/memory-reset'
301
- alias memory-profile='~/.claude-memory/bin/memory-profile'
302
- alias memory-graph='~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py'
303
- alias memory-patterns='~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py'
299
+ alias memory-status='~/.superlocalmemory/bin/memory-status'
300
+ alias memory-reset='~/.superlocalmemory/bin/memory-reset'
301
+ alias memory-profile='~/.superlocalmemory/bin/memory-profile'
302
+ alias memory-graph='~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py'
303
+ alias memory-patterns='~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py'
304
304
  ```
305
305
 
306
306
  Then reload: `source ~/.bashrc` or `source ~/.zshrc`
@@ -332,15 +332,15 @@ All destructive commands include:
332
332
 
333
333
  ### Backup Location
334
334
  ```bash
335
- ~/.claude-memory/backups/
335
+ ~/.superlocalmemory/backups/
336
336
  ```
337
337
 
338
338
  Format: `pre-reset-YYYYMMDD-HHMMSS.db`
339
339
 
340
340
  ### Restore from Backup
341
341
  ```bash
342
- cp ~/.claude-memory/backups/pre-reset-20260205-143000.db \
343
- ~/.claude-memory/memory.db
342
+ cp ~/.superlocalmemory/backups/pre-reset-20260205-143000.db \
343
+ ~/.superlocalmemory/memory.db
344
344
  ```
345
345
 
346
346
  ---
@@ -349,18 +349,18 @@ cp ~/.claude-memory/backups/pre-reset-20260205-143000.db \
349
349
 
350
350
  ### Memory Status
351
351
  ```bash
352
- ~/.claude-memory/bin/memory-status
352
+ ~/.superlocalmemory/bin/memory-status
353
353
  # No --help flag, just shows status
354
354
  ```
355
355
 
356
356
  ### Memory Reset
357
357
  ```bash
358
- ~/.claude-memory/bin/memory-reset --help
358
+ ~/.superlocalmemory/bin/memory-reset --help
359
359
  ```
360
360
 
361
361
  ### Memory Profile
362
362
  ```bash
363
- ~/.claude-memory/bin/memory-profile --help
363
+ ~/.superlocalmemory/bin/memory-profile --help
364
364
  ```
365
365
 
366
366
  ---
@@ -370,7 +370,7 @@ cp ~/.claude-memory/backups/pre-reset-20260205-143000.db \
370
370
  ### Daily Usage
371
371
  ```bash
372
372
  # Standalone: Use Python commands directly
373
- python ~/.claude-memory/memory_store_v2.py add "content" --tags tag1
373
+ python ~/.superlocalmemory/memory_store_v2.py add "content" --tags tag1
374
374
 
375
375
  # Optional Claude CLI: Use /remember skill
376
376
  # /remember "content"
@@ -379,10 +379,10 @@ python ~/.claude-memory/memory_store_v2.py add "content" --tags tag1
379
379
  ### Weekly Maintenance
380
380
  ```bash
381
381
  # Rebuild graph (as memories grow)
382
- ~/.claude-memory/venv/bin/python ~/.claude-memory/graph_engine.py build
382
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py build
383
383
 
384
384
  # Update patterns
385
- ~/.claude-memory/venv/bin/python ~/.claude-memory/pattern_learner.py update
385
+ ~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/pattern_learner.py update
386
386
  ```
387
387
 
388
388
  ### Switching Contexts
@@ -419,7 +419,7 @@ memory-profile switch fresh
419
419
  **All commands are safe by default with warnings and confirmations for destructive operations.**
420
420
 
421
421
  For complete documentation, see:
422
- - `~/.claude-memory/docs/README.md` - Main documentation
423
- - `~/.claude-memory/RESET-GUIDE.md` - Reset procedures
424
- - `~/.claude-memory/PROFILES-GUIDE.md` - Profile management
422
+ - `~/.superlocalmemory/docs/README.md` - Main documentation
423
+ - `~/.superlocalmemory/RESET-GUIDE.md` - Reset procedures
424
+ - `~/.superlocalmemory/PROFILES-GUIDE.md` - Profile management
425
425
  - `docs/ARCHITECTURE.md` - All features
@@ -87,7 +87,7 @@ Main controller that runs full compression cycle:
87
87
 
88
88
  ## Configuration
89
89
 
90
- Located in `~/.claude-memory/config.json`:
90
+ Located in `~/.superlocalmemory/config.json`:
91
91
 
92
92
  ```json
93
93
  {
@@ -117,28 +117,28 @@ Located in `~/.claude-memory/config.json`:
117
117
 
118
118
  ```bash
119
119
  # Initialize compression configuration
120
- ~/.claude-memory/memory-compress init-config
120
+ ~/.superlocalmemory/memory-compress init-config
121
121
 
122
122
  # Classify memories into tiers
123
- ~/.claude-memory/memory-compress classify
123
+ ~/.superlocalmemory/memory-compress classify
124
124
 
125
125
  # Run full compression cycle
126
- ~/.claude-memory/memory-compress compress
126
+ ~/.superlocalmemory/memory-compress compress
127
127
 
128
128
  # Show compression statistics
129
- ~/.claude-memory/memory-compress stats
129
+ ~/.superlocalmemory/memory-compress stats
130
130
 
131
131
  # Compress specific memory to Tier 2
132
- ~/.claude-memory/memory-compress tier2 <id>
132
+ ~/.superlocalmemory/memory-compress tier2 <id>
133
133
 
134
134
  # Compress specific memory to Tier 3
135
- ~/.claude-memory/memory-compress tier3 <id>
135
+ ~/.superlocalmemory/memory-compress tier3 <id>
136
136
 
137
137
  # Move old memories to cold storage
138
- ~/.claude-memory/memory-compress cold-storage
138
+ ~/.superlocalmemory/memory-compress cold-storage
139
139
 
140
140
  # Restore memory from cold storage
141
- ~/.claude-memory/memory-compress restore <id>
141
+ ~/.superlocalmemory/memory-compress restore <id>
142
142
  ```
143
143
 
144
144
  ### Python API
@@ -161,7 +161,7 @@ print(f"Space savings: {stats['space_savings']['savings_percent']}%")
161
161
 
162
162
  The system includes a daily cron job script at:
163
163
  ```
164
- ~/.claude-memory/jobs/compress-memories.sh
164
+ ~/.superlocalmemory/jobs/compress-memories.sh
165
165
  ```
166
166
 
167
167
  #### Setup Cron Job
@@ -173,7 +173,7 @@ crontab -e
173
173
 
174
174
  2. Add this line (runs daily at 3 AM):
175
175
  ```
176
- 0 3 * * * ~/.claude-memory/jobs/compress-memories.sh >> ~/.claude-memory/logs/compression.log 2>&1
176
+ 0 3 * * * ~/.superlocalmemory/jobs/compress-memories.sh >> ~/.superlocalmemory/logs/compression.log 2>&1
177
177
  ```
178
178
 
179
179
  3. Save and exit
@@ -185,7 +185,7 @@ crontab -e
185
185
  3. Compresses Tier 2 memories
186
186
  4. Compresses Tier 3 memories
187
187
  5. Moves old memories to cold storage
188
- 6. Logs results to `~/.claude-memory/logs/compression.log`
188
+ 6. Logs results to `~/.superlocalmemory/logs/compression.log`
189
189
  7. Cleans up backups older than 7 days
190
190
 
191
191
  ## Database Schema
@@ -274,22 +274,22 @@ content = cold_storage.restore_from_cold_storage(memory_id)
274
274
  #### Manual Restore from Backup
275
275
  ```bash
276
276
  # List backups
277
- ls ~/.claude-memory/backups/
277
+ ls ~/.superlocalmemory/backups/
278
278
 
279
279
  # Restore from backup
280
- cp ~/.claude-memory/backups/memory-20260205.db ~/.claude-memory/memory.db
280
+ cp ~/.superlocalmemory/backups/memory-20260205.db ~/.superlocalmemory/memory.db
281
281
  ```
282
282
 
283
283
  ## Monitoring
284
284
 
285
285
  ### Check Compression Stats
286
286
  ```bash
287
- ~/.claude-memory/memory-compress stats
287
+ ~/.superlocalmemory/memory-compress stats
288
288
  ```
289
289
 
290
290
  ### View Compression Logs
291
291
  ```bash
292
- tail -f ~/.claude-memory/logs/compression.log
292
+ tail -f ~/.superlocalmemory/logs/compression.log
293
293
  ```
294
294
 
295
295
  ### Check Cron Job Status
@@ -298,7 +298,7 @@ tail -f ~/.claude-memory/logs/compression.log
298
298
  crontab -l
299
299
 
300
300
  # Check last run
301
- ls -lt ~/.claude-memory/logs/compression.log
301
+ ls -lt ~/.superlocalmemory/logs/compression.log
302
302
  ```
303
303
 
304
304
  ## Troubleshooting
@@ -307,7 +307,7 @@ ls -lt ~/.claude-memory/logs/compression.log
307
307
 
308
308
  1. Check if enabled in config:
309
309
  ```bash
310
- cat ~/.claude-memory/config.json | grep -A 6 compression
310
+ cat ~/.superlocalmemory/config.json | grep -A 6 compression
311
311
  ```
312
312
 
313
313
  2. Check cron job is set:
@@ -317,14 +317,14 @@ crontab -l | grep compress
317
317
 
318
318
  3. Check logs for errors:
319
319
  ```bash
320
- tail -50 ~/.claude-memory/logs/compression.log
320
+ tail -50 ~/.superlocalmemory/logs/compression.log
321
321
  ```
322
322
 
323
323
  ### Memory Not Being Compressed
324
324
 
325
325
  Check tier classification:
326
326
  ```bash
327
- sqlite3 ~/.claude-memory/memory.db "SELECT id, tier, importance, created_at FROM memories WHERE id = <id>;"
327
+ sqlite3 ~/.superlocalmemory/memory.db "SELECT id, tier, importance, created_at FROM memories WHERE id = <id>;"
328
328
  ```
329
329
 
330
330
  Possible reasons:
@@ -336,13 +336,13 @@ Possible reasons:
336
336
 
337
337
  1. Check if in archive table:
338
338
  ```bash
339
- sqlite3 ~/.claude-memory/memory.db "SELECT memory_id FROM memory_archive WHERE memory_id = <id>;"
339
+ sqlite3 ~/.superlocalmemory/memory.db "SELECT memory_id FROM memory_archive WHERE memory_id = <id>;"
340
340
  ```
341
341
 
342
342
  2. Check cold storage:
343
343
  ```bash
344
- ls ~/.claude-memory/cold-storage/
345
- zgrep '"id": <id>' ~/.claude-memory/cold-storage/archive-*.json.gz
344
+ ls ~/.superlocalmemory/cold-storage/
345
+ zgrep '"id": <id>' ~/.superlocalmemory/cold-storage/archive-*.json.gz
346
346
  ```
347
347
 
348
348
  ## Files