superlocalmemory 3.0.10 → 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.
- package/README.md +15 -0
- package/bin/slm.bat +14 -184
- package/bin/slm.cmd +2 -7
- package/docs/api-reference.md +1 -1
- package/docs/migration-from-v2.md +4 -4
- package/docs/v2-archive/ARCHITECTURE.md +1 -1
- package/docs/v2-archive/CLI-COMMANDS-REFERENCE.md +35 -35
- package/docs/v2-archive/COMPRESSION-README.md +23 -23
- package/docs/v2-archive/FRAMEWORK-INTEGRATIONS.md +2 -2
- package/docs/v2-archive/MCP-MANUAL-SETUP.md +10 -10
- package/docs/v2-archive/MCP-TROUBLESHOOTING.md +29 -29
- package/docs/v2-archive/PATTERN-LEARNING.md +2 -2
- package/docs/v2-archive/PROFILES-GUIDE.md +52 -52
- package/docs/v2-archive/RESET-GUIDE.md +36 -36
- package/docs/v2-archive/UI-SERVER.md +2 -2
- package/docs/v2-archive/UNIVERSAL-INTEGRATION.md +3 -3
- package/docs/v2-archive/V2.2.0-OPTIONAL-SEARCH.md +2 -2
- package/ide/configs/antigravity-mcp.json +5 -7
- package/ide/configs/claude-desktop-mcp.json +3 -7
- package/ide/configs/codex-mcp.toml +2 -4
- package/ide/configs/continue-mcp.yaml +2 -3
- package/ide/configs/cursor-mcp.json +3 -7
- package/ide/configs/gemini-cli-mcp.json +6 -6
- package/ide/configs/jetbrains-mcp.json +6 -6
- package/ide/configs/opencode-mcp.json +5 -7
- package/ide/configs/perplexity-mcp.json +6 -6
- package/ide/configs/vscode-copilot-mcp.json +5 -6
- package/ide/configs/windsurf-mcp.json +3 -8
- package/ide/configs/zed-mcp.json +5 -6
- package/ide/integrations/langchain/README.md +3 -3
- package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py +5 -5
- package/ide/integrations/langchain/pyproject.toml +2 -2
- package/ide/integrations/llamaindex/README.md +2 -2
- package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py +4 -4
- package/ide/integrations/llamaindex/pyproject.toml +2 -2
- package/ide/skills/slm-show-patterns/SKILL.md +1 -1
- package/package.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/build-dmg.sh +8 -8
- package/scripts/install-skills.ps1 +2 -2
- package/scripts/install-skills.sh +3 -3
- package/scripts/install.ps1 +13 -13
- package/scripts/install.sh +9 -9
- package/scripts/preuninstall.js +1 -1
- package/scripts/sync-wiki.ps1 +3 -3
- package/scripts/sync-wiki.sh +3 -3
- package/scripts/test-dmg.sh +1 -1
- package/scripts/test-npm-package.ps1 +1 -1
- package/scripts/test-npm-package.sh +1 -1
- package/scripts/verify-install.ps1 +1 -1
- package/scripts/verify-install.sh +4 -4
- package/scripts/verify-v27.ps1 +3 -3
- package/scripts/verify-v27.sh +3 -3
- package/src/superlocalmemory/cli/commands.py +8 -0
- package/src/superlocalmemory/cli/main.py +3 -0
- package/src/superlocalmemory/cli/post_install.py +1 -1
- package/src/superlocalmemory/core/engine.py +2 -1
- package/src/superlocalmemory/hooks/ide_connector.py +2 -2
- package/src/superlocalmemory.egg-info/PKG-INFO +32 -4
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
|
|
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/
|
|
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
|
|
12
|
-
|
|
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 :
|
|
13
|
+
goto :run
|
|
40
14
|
)
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
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
|
-
|
|
78
|
-
|
|
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
|
-
:
|
|
102
|
-
|
|
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
|
|
3
|
-
REM
|
|
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%
|
package/docs/api-reference.md
CHANGED
|
@@ -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** | `~/.
|
|
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 `~/.
|
|
56
|
-
3. Creates a symlink (`~/.
|
|
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 `~/.
|
|
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 (~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
277
|
+
python ~/.superlocalmemory/memory_store_v2.py search "query"
|
|
278
278
|
```
|
|
279
279
|
|
|
280
280
|
### List Recent Memories
|
|
281
281
|
```bash
|
|
282
|
-
python ~/.
|
|
282
|
+
python ~/.superlocalmemory/memory_store_v2.py list 20
|
|
283
283
|
```
|
|
284
284
|
|
|
285
285
|
### Get Stats
|
|
286
286
|
```bash
|
|
287
|
-
python ~/.
|
|
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='~/.
|
|
300
|
-
alias memory-reset='~/.
|
|
301
|
-
alias memory-profile='~/.
|
|
302
|
-
alias memory-graph='~/.
|
|
303
|
-
alias memory-patterns='~/.
|
|
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
|
-
~/.
|
|
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 ~/.
|
|
343
|
-
~/.
|
|
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
|
-
~/.
|
|
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
|
-
~/.
|
|
358
|
+
~/.superlocalmemory/bin/memory-reset --help
|
|
359
359
|
```
|
|
360
360
|
|
|
361
361
|
### Memory Profile
|
|
362
362
|
```bash
|
|
363
|
-
~/.
|
|
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 ~/.
|
|
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
|
-
~/.
|
|
382
|
+
~/.superlocalmemory/venv/bin/python ~/.superlocalmemory/graph_engine.py build
|
|
383
383
|
|
|
384
384
|
# Update patterns
|
|
385
|
-
~/.
|
|
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
|
-
- `~/.
|
|
423
|
-
- `~/.
|
|
424
|
-
- `~/.
|
|
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 `~/.
|
|
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
|
-
~/.
|
|
120
|
+
~/.superlocalmemory/memory-compress init-config
|
|
121
121
|
|
|
122
122
|
# Classify memories into tiers
|
|
123
|
-
~/.
|
|
123
|
+
~/.superlocalmemory/memory-compress classify
|
|
124
124
|
|
|
125
125
|
# Run full compression cycle
|
|
126
|
-
~/.
|
|
126
|
+
~/.superlocalmemory/memory-compress compress
|
|
127
127
|
|
|
128
128
|
# Show compression statistics
|
|
129
|
-
~/.
|
|
129
|
+
~/.superlocalmemory/memory-compress stats
|
|
130
130
|
|
|
131
131
|
# Compress specific memory to Tier 2
|
|
132
|
-
~/.
|
|
132
|
+
~/.superlocalmemory/memory-compress tier2 <id>
|
|
133
133
|
|
|
134
134
|
# Compress specific memory to Tier 3
|
|
135
|
-
~/.
|
|
135
|
+
~/.superlocalmemory/memory-compress tier3 <id>
|
|
136
136
|
|
|
137
137
|
# Move old memories to cold storage
|
|
138
|
-
~/.
|
|
138
|
+
~/.superlocalmemory/memory-compress cold-storage
|
|
139
139
|
|
|
140
140
|
# Restore memory from cold storage
|
|
141
|
-
~/.
|
|
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
|
-
~/.
|
|
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 * * * ~/.
|
|
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 `~/.
|
|
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 ~/.
|
|
277
|
+
ls ~/.superlocalmemory/backups/
|
|
278
278
|
|
|
279
279
|
# Restore from backup
|
|
280
|
-
cp ~/.
|
|
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
|
-
~/.
|
|
287
|
+
~/.superlocalmemory/memory-compress stats
|
|
288
288
|
```
|
|
289
289
|
|
|
290
290
|
### View Compression Logs
|
|
291
291
|
```bash
|
|
292
|
-
tail -f ~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
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 ~/.
|
|
345
|
-
zgrep '"id": <id>' ~/.
|
|
344
|
+
ls ~/.superlocalmemory/cold-storage/
|
|
345
|
+
zgrep '"id": <id>' ~/.superlocalmemory/cold-storage/archive-*.json.gz
|
|
346
346
|
```
|
|
347
347
|
|
|
348
348
|
## Files
|