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.
- 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/hooks/ide_connector.py +2 -2
- package/src/superlocalmemory.egg-info/PKG-INFO +16 -1
|
@@ -82,7 +82,7 @@ history.clear()
|
|
|
82
82
|
|
|
83
83
|
### Storage Details
|
|
84
84
|
|
|
85
|
-
- Messages persist in `~/.
|
|
85
|
+
- Messages persist in `~/.superlocalmemory/memory.db`
|
|
86
86
|
- Each message stored as a memory with tags: `langchain`, `chat`, `session:<session_id>`
|
|
87
87
|
- Supports all LangChain message types (HumanMessage, AIMessage, SystemMessage)
|
|
88
88
|
- Automatic timestamp and metadata tracking
|
|
@@ -176,7 +176,7 @@ all_chats = chat_store.get_keys()
|
|
|
176
176
|
|
|
177
177
|
### Storage Details
|
|
178
178
|
|
|
179
|
-
- Messages persist in `~/.
|
|
179
|
+
- Messages persist in `~/.superlocalmemory/memory.db`
|
|
180
180
|
- Each message stored as a memory with tags: `llamaindex`, `chat`, `key:<chat_store_key>`
|
|
181
181
|
- Supports all LlamaIndex ChatMessage roles (user, assistant, system)
|
|
182
182
|
- Automatic timestamp tracking
|
|
@@ -58,7 +58,7 @@ For tools marked ⚠️, follow the manual setup instructions below.
|
|
|
58
58
|
|
|
59
59
|
4. **Know your install directory:**
|
|
60
60
|
```bash
|
|
61
|
-
echo ~/.
|
|
61
|
+
echo ~/.superlocalmemory
|
|
62
62
|
# Default: /Users/yourusername/.claude-memory
|
|
63
63
|
```
|
|
64
64
|
|
|
@@ -417,7 +417,7 @@ PYTHONPATH = "/Users/yourusername/.claude-memory"
|
|
|
417
417
|
# or with streamable-http transport (ChatGPT 2026+):
|
|
418
418
|
slm serve --port 8417 --transport streamable-http
|
|
419
419
|
# or using Python directly:
|
|
420
|
-
python3 ~/.
|
|
420
|
+
python3 ~/.superlocalmemory/mcp_server.py --transport http --port 8417
|
|
421
421
|
```
|
|
422
422
|
|
|
423
423
|
2. **Expose via cloudflared tunnel** (in another terminal):
|
|
@@ -542,7 +542,7 @@ For any MCP client that requires HTTP transport (ChatGPT, remote access, web-bas
|
|
|
542
542
|
slm serve --port 8001
|
|
543
543
|
|
|
544
544
|
# Using Python directly
|
|
545
|
-
python3 ~/.
|
|
545
|
+
python3 ~/.superlocalmemory/mcp_server.py --transport http --port 8001
|
|
546
546
|
```
|
|
547
547
|
|
|
548
548
|
**For local access:**
|
|
@@ -593,7 +593,7 @@ print(response)
|
|
|
593
593
|
|
|
594
594
|
Start MCP server in HTTP mode:
|
|
595
595
|
```bash
|
|
596
|
-
python3 ~/.
|
|
596
|
+
python3 ~/.superlocalmemory/mcp_server.py --transport http --port 8001
|
|
597
597
|
```
|
|
598
598
|
|
|
599
599
|
Then connect via HTTP:
|
|
@@ -610,11 +610,11 @@ http://localhost:8001
|
|
|
610
610
|
**Solution:**
|
|
611
611
|
1. Verify file exists:
|
|
612
612
|
```bash
|
|
613
|
-
ls -la ~/.
|
|
613
|
+
ls -la ~/.superlocalmemory/mcp_server.py
|
|
614
614
|
```
|
|
615
615
|
2. Check permissions:
|
|
616
616
|
```bash
|
|
617
|
-
chmod +x ~/.
|
|
617
|
+
chmod +x ~/.superlocalmemory/mcp_server.py
|
|
618
618
|
```
|
|
619
619
|
|
|
620
620
|
### Issue 2: "ModuleNotFoundError: No module named 'mcp'"
|
|
@@ -644,7 +644,7 @@ conda install -c conda-forge mcp
|
|
|
644
644
|
1. Verify `cwd` and `PYTHONPATH` are set in config
|
|
645
645
|
2. Check modules exist:
|
|
646
646
|
```bash
|
|
647
|
-
ls ~/.
|
|
647
|
+
ls ~/.superlocalmemory/memory_store_v2.py
|
|
648
648
|
```
|
|
649
649
|
|
|
650
650
|
### Issue 5: IDE doesn't show MCP tools
|
|
@@ -654,7 +654,7 @@ conda install -c conda-forge mcp
|
|
|
654
654
|
2. Check IDE's MCP settings/logs
|
|
655
655
|
3. Test MCP server manually:
|
|
656
656
|
```bash
|
|
657
|
-
python3 ~/.
|
|
657
|
+
python3 ~/.superlocalmemory/mcp_server.py
|
|
658
658
|
# Should start without errors
|
|
659
659
|
```
|
|
660
660
|
|
|
@@ -676,7 +676,7 @@ After setup, verify MCP integration works:
|
|
|
676
676
|
### 1. Check MCP Server Status
|
|
677
677
|
|
|
678
678
|
```bash
|
|
679
|
-
python3 ~/.
|
|
679
|
+
python3 ~/.superlocalmemory/mcp_server.py
|
|
680
680
|
```
|
|
681
681
|
|
|
682
682
|
**Expected output:**
|
|
@@ -763,7 +763,7 @@ Plus **2 MCP prompts** and **6 MCP resources** for advanced use.
|
|
|
763
763
|
## Need Help?
|
|
764
764
|
|
|
765
765
|
1. **Check logs:** Most IDEs have MCP server logs in their developer tools
|
|
766
|
-
2. **Test manually:** Run `python3 ~/.
|
|
766
|
+
2. **Test manually:** Run `python3 ~/.superlocalmemory/mcp_server.py` to see errors
|
|
767
767
|
3. **GitHub Issues:** https://github.com/qualixar/superlocalmemory/issues
|
|
768
768
|
4. **Documentation:** https://github.com/qualixar/superlocalmemory
|
|
769
769
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
### Step 1: Verify MCP Server Works Standalone
|
|
10
10
|
```bash
|
|
11
|
-
python3 ~/.
|
|
11
|
+
python3 ~/.superlocalmemory/mcp_server.py
|
|
12
12
|
```
|
|
13
13
|
|
|
14
14
|
**Expected output:**
|
|
@@ -90,7 +90,7 @@ python3 -c "import mcp"
|
|
|
90
90
|
# Should complete without error
|
|
91
91
|
|
|
92
92
|
python3 -c "import sys; print('\n'.join(sys.path))"
|
|
93
|
-
# Should show paths including ~/.
|
|
93
|
+
# Should show paths including ~/.superlocalmemory
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
**If Python issues, see Issue 2 or 4 below.**
|
|
@@ -103,17 +103,17 @@ python3 -c "import sys; print('\n'.join(sys.path))"
|
|
|
103
103
|
|
|
104
104
|
**Symptoms:**
|
|
105
105
|
```bash
|
|
106
|
-
$ python3 ~/.
|
|
106
|
+
$ python3 ~/.superlocalmemory/mcp_server.py
|
|
107
107
|
Error: Could not import SuperLocalMemory modules
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
**Diagnosis:**
|
|
111
111
|
```bash
|
|
112
112
|
# Check if files exist
|
|
113
|
-
ls -la ~/.
|
|
114
|
-
ls -la ~/.
|
|
115
|
-
ls -la ~/.
|
|
116
|
-
ls -la ~/.
|
|
113
|
+
ls -la ~/.superlocalmemory/mcp_server.py
|
|
114
|
+
ls -la ~/.superlocalmemory/memory_store_v2.py
|
|
115
|
+
ls -la ~/.superlocalmemory/graph_engine.py
|
|
116
|
+
ls -la ~/.superlocalmemory/pattern_learner.py
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
**Fix:**
|
|
@@ -125,13 +125,13 @@ ls -la ~/.claude-memory/pattern_learner.py
|
|
|
125
125
|
|
|
126
126
|
2. Check permissions:
|
|
127
127
|
```bash
|
|
128
|
-
chmod +x ~/.
|
|
129
|
-
chmod +x ~/.
|
|
128
|
+
chmod +x ~/.superlocalmemory/mcp_server.py
|
|
129
|
+
chmod +x ~/.superlocalmemory/*.py
|
|
130
130
|
```
|
|
131
131
|
|
|
132
132
|
3. Test imports:
|
|
133
133
|
```bash
|
|
134
|
-
cd ~/.
|
|
134
|
+
cd ~/.superlocalmemory
|
|
135
135
|
python3 -c "from memory_store_v2 import MemoryStoreV2"
|
|
136
136
|
```
|
|
137
137
|
|
|
@@ -286,12 +286,12 @@ Most common mistake - missing `cwd` or `PYTHONPATH`:
|
|
|
286
286
|
|
|
287
287
|
**Diagnosis:**
|
|
288
288
|
```bash
|
|
289
|
-
cd ~/.
|
|
289
|
+
cd ~/.superlocalmemory
|
|
290
290
|
python3 -c "from memory_store_v2 import MemoryStoreV2"
|
|
291
291
|
# Should work without error
|
|
292
292
|
|
|
293
293
|
# Check if files exist
|
|
294
|
-
ls -la ~/.
|
|
294
|
+
ls -la ~/.superlocalmemory/*.py
|
|
295
295
|
```
|
|
296
296
|
|
|
297
297
|
**Fix:**
|
|
@@ -316,8 +316,8 @@ Add `PYTHONPATH` to config (if missing):
|
|
|
316
316
|
|
|
317
317
|
**Verify with test:**
|
|
318
318
|
```bash
|
|
319
|
-
cd ~/.
|
|
320
|
-
PYTHONPATH=~/.
|
|
319
|
+
cd ~/.superlocalmemory
|
|
320
|
+
PYTHONPATH=~/.superlocalmemory python3 -c "from memory_store_v2 import MemoryStoreV2; print('OK')"
|
|
321
321
|
```
|
|
322
322
|
|
|
323
323
|
---
|
|
@@ -367,10 +367,10 @@ cp ~/.cursor/mcp_settings.json ~/.cursor/mcp_settings.json.custom
|
|
|
367
367
|
**Diagnosis:**
|
|
368
368
|
```bash
|
|
369
369
|
# Check database exists and is writable
|
|
370
|
-
ls -la ~/.
|
|
370
|
+
ls -la ~/.superlocalmemory/memory.db
|
|
371
371
|
|
|
372
372
|
# Check it's not empty
|
|
373
|
-
sqlite3 ~/.
|
|
373
|
+
sqlite3 ~/.superlocalmemory/memory.db "SELECT COUNT(*) FROM memories;"
|
|
374
374
|
|
|
375
375
|
# Check multiple tools use same database
|
|
376
376
|
# (They all should point to same file)
|
|
@@ -381,7 +381,7 @@ sqlite3 ~/.claude-memory/memory.db "SELECT COUNT(*) FROM memories;"
|
|
|
381
381
|
**1. Verify database location:**
|
|
382
382
|
```bash
|
|
383
383
|
# All tools should use this path
|
|
384
|
-
~/.
|
|
384
|
+
~/.superlocalmemory/memory.db
|
|
385
385
|
|
|
386
386
|
# NOT multiple databases like:
|
|
387
387
|
# ~/.cursor/memory.db ❌
|
|
@@ -390,11 +390,11 @@ sqlite3 ~/.claude-memory/memory.db "SELECT COUNT(*) FROM memories;"
|
|
|
390
390
|
|
|
391
391
|
**2. Check write permissions:**
|
|
392
392
|
```bash
|
|
393
|
-
ls -ld ~/.
|
|
393
|
+
ls -ld ~/.superlocalmemory/
|
|
394
394
|
# Should NOT be read-only
|
|
395
395
|
|
|
396
|
-
chmod 755 ~/.
|
|
397
|
-
chmod 644 ~/.
|
|
396
|
+
chmod 755 ~/.superlocalmemory/
|
|
397
|
+
chmod 644 ~/.superlocalmemory/memory.db
|
|
398
398
|
```
|
|
399
399
|
|
|
400
400
|
**3. Check database not locked:**
|
|
@@ -404,7 +404,7 @@ ps aux | grep mcp_server
|
|
|
404
404
|
kill <PID> # If any found
|
|
405
405
|
|
|
406
406
|
# Test database access
|
|
407
|
-
sqlite3 ~/.
|
|
407
|
+
sqlite3 ~/.superlocalmemory/memory.db "PRAGMA integrity_check;"
|
|
408
408
|
# Should output: ok
|
|
409
409
|
```
|
|
410
410
|
|
|
@@ -420,7 +420,7 @@ sqlite3 ~/.claude-memory/memory.db "PRAGMA integrity_check;"
|
|
|
420
420
|
**Diagnosis:**
|
|
421
421
|
```bash
|
|
422
422
|
# Start server with debug output
|
|
423
|
-
python3 ~/.
|
|
423
|
+
python3 ~/.superlocalmemory/mcp_server.py 2>&1 | tee /tmp/mcp-debug.log
|
|
424
424
|
|
|
425
425
|
# In another terminal, try to trigger crash
|
|
426
426
|
# Then check log:
|
|
@@ -448,7 +448,7 @@ cat /tmp/mcp-debug.log
|
|
|
448
448
|
**3. Database locked:**
|
|
449
449
|
```bash
|
|
450
450
|
# Check for other processes
|
|
451
|
-
lsof ~/.
|
|
451
|
+
lsof ~/.superlocalmemory/memory.db
|
|
452
452
|
|
|
453
453
|
# Kill if needed
|
|
454
454
|
kill <PID>
|
|
@@ -457,10 +457,10 @@ kill <PID>
|
|
|
457
457
|
**4. Corrupted database:**
|
|
458
458
|
```bash
|
|
459
459
|
# Check integrity
|
|
460
|
-
sqlite3 ~/.
|
|
460
|
+
sqlite3 ~/.superlocalmemory/memory.db "PRAGMA integrity_check;"
|
|
461
461
|
|
|
462
462
|
# If corrupted, restore from backup
|
|
463
|
-
cp ~/.
|
|
463
|
+
cp ~/.superlocalmemory/backups/memory.db.backup.* ~/.superlocalmemory/memory.db
|
|
464
464
|
```
|
|
465
465
|
|
|
466
466
|
---
|
|
@@ -698,7 +698,7 @@ If auto-configuration fails completely, manually add to your IDE's config:
|
|
|
698
698
|
|
|
699
699
|
**Steps:**
|
|
700
700
|
1. Find Python: `which python3`
|
|
701
|
-
2. Find install dir: `echo ~/.
|
|
701
|
+
2. Find install dir: `echo ~/.superlocalmemory`
|
|
702
702
|
3. Replace paths above with YOUR actual paths
|
|
703
703
|
4. Validate JSON: `cat config.json | python3 -m json.tool`
|
|
704
704
|
5. Restart IDE completely
|
|
@@ -711,7 +711,7 @@ If auto-configuration fails completely, manually add to your IDE's config:
|
|
|
711
711
|
### Before Opening an Issue
|
|
712
712
|
|
|
713
713
|
1. ✅ **Check logs** (see IDE-specific sections)
|
|
714
|
-
2. ✅ **Test server manually:** `python3 ~/.
|
|
714
|
+
2. ✅ **Test server manually:** `python3 ~/.superlocalmemory/mcp_server.py`
|
|
715
715
|
3. ✅ **Verify config is valid JSON**
|
|
716
716
|
4. ✅ **Try manual configuration** (see above)
|
|
717
717
|
5. ✅ **Search existing issues:** https://github.com/qualixar/superlocalmemory/issues
|
|
@@ -724,7 +724,7 @@ If auto-configuration fails completely, manually add to your IDE's config:
|
|
|
724
724
|
- **Python:** Output of `python3 --version`
|
|
725
725
|
- **Config file:** Contents (redact sensitive paths if needed)
|
|
726
726
|
- **Error message:** Exact error from logs
|
|
727
|
-
- **Manual test:** Output of `python3 ~/.
|
|
727
|
+
- **Manual test:** Output of `python3 ~/.superlocalmemory/mcp_server.py`
|
|
728
728
|
- **What you tried:** List troubleshooting steps already attempted
|
|
729
729
|
|
|
730
730
|
**Template:**
|
|
@@ -739,7 +739,7 @@ If auto-configuration fails completely, manually add to your IDE's config:
|
|
|
739
739
|
[paste config here]
|
|
740
740
|
|
|
741
741
|
**Manual test:**
|
|
742
|
-
$ python3 ~/.
|
|
742
|
+
$ python3 ~/.superlocalmemory/mcp_server.py
|
|
743
743
|
[paste output here]
|
|
744
744
|
|
|
745
745
|
**What I tried:**
|
|
@@ -123,7 +123,7 @@ The system is designed to be conservative. Low confidence with small datasets is
|
|
|
123
123
|
- Recommended cron job:
|
|
124
124
|
```bash
|
|
125
125
|
# Every Sunday at 2 AM
|
|
126
|
-
0 2 * * 0 cd ~/.
|
|
126
|
+
0 2 * * 0 cd ~/.superlocalmemory && python3 pattern_learner.py update >> pattern_updates.log 2>&1
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
---
|
|
@@ -159,7 +159,7 @@ prompt = f"""
|
|
|
159
159
|
## Privacy & Security
|
|
160
160
|
|
|
161
161
|
- **No external API calls** — all processing is local
|
|
162
|
-
- **All data stays local** — stored in `~/.
|
|
162
|
+
- **All data stays local** — stored in `~/.superlocalmemory/`
|
|
163
163
|
- **SQL injection protected** — parameterized queries throughout
|
|
164
164
|
- **No credentials stored**
|
|
165
165
|
- **No network access required**
|
|
@@ -16,35 +16,35 @@
|
|
|
16
16
|
|
|
17
17
|
### List Profiles
|
|
18
18
|
```bash
|
|
19
|
-
python ~/.
|
|
19
|
+
python ~/.superlocalmemory/memory-profiles.py list
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
### Show Current Profile
|
|
23
23
|
```bash
|
|
24
|
-
python ~/.
|
|
24
|
+
python ~/.superlocalmemory/memory-profiles.py current
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
### Create New Profile
|
|
28
28
|
```bash
|
|
29
29
|
# Empty profile
|
|
30
|
-
python ~/.
|
|
30
|
+
python ~/.superlocalmemory/memory-profiles.py create work \
|
|
31
31
|
--description "Work projects"
|
|
32
32
|
|
|
33
33
|
# Copy current memories to new profile
|
|
34
|
-
python ~/.
|
|
34
|
+
python ~/.superlocalmemory/memory-profiles.py create personal \
|
|
35
35
|
--from-current
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
### Switch Profile
|
|
39
39
|
```bash
|
|
40
|
-
python ~/.
|
|
40
|
+
python ~/.superlocalmemory/memory-profiles.py switch work
|
|
41
41
|
|
|
42
42
|
# ⚠️ IMPORTANT: Restart Claude CLI after switching!
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
### Delete Profile
|
|
46
46
|
```bash
|
|
47
|
-
python ~/.
|
|
47
|
+
python ~/.superlocalmemory/memory-profiles.py delete old-profile
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
---
|
|
@@ -72,16 +72,16 @@ Each profile has its own:
|
|
|
72
72
|
|
|
73
73
|
```bash
|
|
74
74
|
# Create work profile
|
|
75
|
-
python ~/.
|
|
75
|
+
python ~/.superlocalmemory/memory-profiles.py create work \
|
|
76
76
|
--description "Professional coding projects"
|
|
77
77
|
|
|
78
78
|
# Create personal profile from current
|
|
79
|
-
python ~/.
|
|
79
|
+
python ~/.superlocalmemory/memory-profiles.py create personal \
|
|
80
80
|
--from-current --description "Personal learning and experiments"
|
|
81
81
|
|
|
82
82
|
# Switch based on context
|
|
83
|
-
python ~/.
|
|
84
|
-
python ~/.
|
|
83
|
+
python ~/.superlocalmemory/memory-profiles.py switch work # During work hours
|
|
84
|
+
python ~/.superlocalmemory/memory-profiles.py switch personal # Personal time
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
**Result:**
|
|
@@ -94,14 +94,14 @@ python ~/.claude-memory/memory-profiles.py switch personal # Personal time
|
|
|
94
94
|
|
|
95
95
|
```bash
|
|
96
96
|
# Create profile per client
|
|
97
|
-
python ~/.
|
|
97
|
+
python ~/.superlocalmemory/memory-profiles.py create client-acme \
|
|
98
98
|
--description "Acme Corp project"
|
|
99
99
|
|
|
100
|
-
python ~/.
|
|
100
|
+
python ~/.superlocalmemory/memory-profiles.py create client-contoso \
|
|
101
101
|
--description "Contoso Inc project"
|
|
102
102
|
|
|
103
103
|
# Switch when working on different clients
|
|
104
|
-
python ~/.
|
|
104
|
+
python ~/.superlocalmemory/memory-profiles.py switch client-acme
|
|
105
105
|
```
|
|
106
106
|
|
|
107
107
|
**Benefits:**
|
|
@@ -115,17 +115,17 @@ python ~/.claude-memory/memory-profiles.py switch client-acme
|
|
|
115
115
|
|
|
116
116
|
```bash
|
|
117
117
|
# Create test profile
|
|
118
|
-
python ~/.
|
|
118
|
+
python ~/.superlocalmemory/memory-profiles.py create experimental \
|
|
119
119
|
--description "Testing new features"
|
|
120
120
|
|
|
121
121
|
# Switch to test profile
|
|
122
|
-
python ~/.
|
|
122
|
+
python ~/.superlocalmemory/memory-profiles.py switch experimental
|
|
123
123
|
|
|
124
124
|
# Try new things without polluting main profile
|
|
125
125
|
# ...test features...
|
|
126
126
|
|
|
127
127
|
# Switch back when done
|
|
128
|
-
python ~/.
|
|
128
|
+
python ~/.superlocalmemory/memory-profiles.py switch default
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
---
|
|
@@ -134,16 +134,16 @@ python ~/.claude-memory/memory-profiles.py switch default
|
|
|
134
134
|
|
|
135
135
|
```bash
|
|
136
136
|
# Strict architect profile
|
|
137
|
-
python ~/.
|
|
137
|
+
python ~/.superlocalmemory/memory-profiles.py create architect \
|
|
138
138
|
--description "Rigorous architecture-first approach"
|
|
139
139
|
|
|
140
140
|
# Rapid prototyper profile
|
|
141
|
-
python ~/.
|
|
141
|
+
python ~/.superlocalmemory/memory-profiles.py create prototyper \
|
|
142
142
|
--description "Fast iteration, MVP-first approach"
|
|
143
143
|
|
|
144
144
|
# Use based on project phase
|
|
145
|
-
python ~/.
|
|
146
|
-
python ~/.
|
|
145
|
+
python ~/.superlocalmemory/memory-profiles.py switch architect # Planning
|
|
146
|
+
python ~/.superlocalmemory/memory-profiles.py switch prototyper # MVP development
|
|
147
147
|
```
|
|
148
148
|
|
|
149
149
|
**Result:** Each profile learns different patterns:
|
|
@@ -159,7 +159,7 @@ python ~/.claude-memory/memory-profiles.py switch prototyper # MVP development
|
|
|
159
159
|
Creates fresh V2 database with no memories:
|
|
160
160
|
|
|
161
161
|
```bash
|
|
162
|
-
python ~/.
|
|
162
|
+
python ~/.superlocalmemory/memory-profiles.py create new-profile
|
|
163
163
|
```
|
|
164
164
|
|
|
165
165
|
**When to use:**
|
|
@@ -174,7 +174,7 @@ python ~/.claude-memory/memory-profiles.py create new-profile
|
|
|
174
174
|
Copies current memory system to new profile:
|
|
175
175
|
|
|
176
176
|
```bash
|
|
177
|
-
python ~/.
|
|
177
|
+
python ~/.superlocalmemory/memory-profiles.py create backup --from-current
|
|
178
178
|
```
|
|
179
179
|
|
|
180
180
|
**When to use:**
|
|
@@ -189,14 +189,14 @@ python ~/.claude-memory/memory-profiles.py create backup --from-current
|
|
|
189
189
|
Changes active profile (requires Claude CLI restart):
|
|
190
190
|
|
|
191
191
|
```bash
|
|
192
|
-
python ~/.
|
|
192
|
+
python ~/.superlocalmemory/memory-profiles.py switch work
|
|
193
193
|
|
|
194
194
|
# Output:
|
|
195
195
|
# Switching from 'default' to 'work'...
|
|
196
196
|
# Saving current state to profile 'default'...
|
|
197
|
-
# ✓ Saved to ~/.
|
|
197
|
+
# ✓ Saved to ~/.superlocalmemory/profiles/default
|
|
198
198
|
# Loading profile 'work'...
|
|
199
|
-
# ✓ Loaded from ~/.
|
|
199
|
+
# ✓ Loaded from ~/.superlocalmemory/profiles/work
|
|
200
200
|
# ✅ Switched to profile: work
|
|
201
201
|
#
|
|
202
202
|
# ⚠️ IMPORTANT: Restart Claude CLI to use new profile!
|
|
@@ -211,7 +211,7 @@ python ~/.claude-memory/memory-profiles.py switch work
|
|
|
211
211
|
Permanently removes a profile:
|
|
212
212
|
|
|
213
213
|
```bash
|
|
214
|
-
python ~/.
|
|
214
|
+
python ~/.superlocalmemory/memory-profiles.py delete old-profile
|
|
215
215
|
|
|
216
216
|
# Prompts: Type profile name 'old-profile' to confirm:
|
|
217
217
|
```
|
|
@@ -227,7 +227,7 @@ python ~/.claude-memory/memory-profiles.py delete old-profile
|
|
|
227
227
|
### Rename Profile
|
|
228
228
|
|
|
229
229
|
```bash
|
|
230
|
-
python ~/.
|
|
230
|
+
python ~/.superlocalmemory/memory-profiles.py rename old-name new-name
|
|
231
231
|
```
|
|
232
232
|
|
|
233
233
|
**Cannot rename:**
|
|
@@ -240,7 +240,7 @@ python ~/.claude-memory/memory-profiles.py rename old-name new-name
|
|
|
240
240
|
|
|
241
241
|
Profiles stored in:
|
|
242
242
|
```
|
|
243
|
-
~/.
|
|
243
|
+
~/.superlocalmemory/profiles/
|
|
244
244
|
├── work/
|
|
245
245
|
│ ├── memory.db
|
|
246
246
|
│ ├── config.json
|
|
@@ -257,7 +257,7 @@ Profiles stored in:
|
|
|
257
257
|
|
|
258
258
|
**Active profile** stored in main location:
|
|
259
259
|
```
|
|
260
|
-
~/.
|
|
260
|
+
~/.superlocalmemory/
|
|
261
261
|
├── memory.db ← Currently active profile
|
|
262
262
|
├── config.json
|
|
263
263
|
└── vectors/
|
|
@@ -267,7 +267,7 @@ Profiles stored in:
|
|
|
267
267
|
|
|
268
268
|
## Profile Configuration
|
|
269
269
|
|
|
270
|
-
Stored in `~/.
|
|
270
|
+
Stored in `~/.superlocalmemory/profiles.json`:
|
|
271
271
|
|
|
272
272
|
```json
|
|
273
273
|
{
|
|
@@ -298,50 +298,50 @@ Stored in `~/.claude-memory/profiles.json`:
|
|
|
298
298
|
### 1. Use Descriptive Names
|
|
299
299
|
```bash
|
|
300
300
|
# Good
|
|
301
|
-
python ~/.
|
|
302
|
-
python ~/.
|
|
301
|
+
python ~/.superlocalmemory/memory-profiles.py create client-acme-api
|
|
302
|
+
python ~/.superlocalmemory/memory-profiles.py create personal-learning
|
|
303
303
|
|
|
304
304
|
# Avoid
|
|
305
|
-
python ~/.
|
|
306
|
-
python ~/.
|
|
305
|
+
python ~/.superlocalmemory/memory-profiles.py create profile1
|
|
306
|
+
python ~/.superlocalmemory/memory-profiles.py create temp
|
|
307
307
|
```
|
|
308
308
|
|
|
309
309
|
### 2. Document Profile Purpose
|
|
310
310
|
```bash
|
|
311
|
-
python ~/.
|
|
311
|
+
python ~/.superlocalmemory/memory-profiles.py create project-x \
|
|
312
312
|
--description "Confidential client X - Next.js + PostgreSQL"
|
|
313
313
|
```
|
|
314
314
|
|
|
315
315
|
### 3. Switch Profiles at Context Boundaries
|
|
316
316
|
```bash
|
|
317
317
|
# Start of work day
|
|
318
|
-
python ~/.
|
|
318
|
+
python ~/.superlocalmemory/memory-profiles.py switch work
|
|
319
319
|
|
|
320
320
|
# End of work day
|
|
321
|
-
python ~/.
|
|
321
|
+
python ~/.superlocalmemory/memory-profiles.py switch personal
|
|
322
322
|
```
|
|
323
323
|
|
|
324
324
|
### 4. Backup Before Major Changes
|
|
325
325
|
```bash
|
|
326
326
|
# Create backup profile
|
|
327
|
-
python ~/.
|
|
327
|
+
python ~/.superlocalmemory/memory-profiles.py create backup-$(date +%Y%m%d) \
|
|
328
328
|
--from-current
|
|
329
329
|
|
|
330
330
|
# Make changes in main profile
|
|
331
331
|
# ...
|
|
332
332
|
|
|
333
333
|
# If needed, switch to backup
|
|
334
|
-
python ~/.
|
|
334
|
+
python ~/.superlocalmemory/memory-profiles.py switch backup-20260205
|
|
335
335
|
```
|
|
336
336
|
|
|
337
337
|
### 5. Archive Completed Projects
|
|
338
338
|
```bash
|
|
339
339
|
# Rename completed project
|
|
340
|
-
python ~/.
|
|
340
|
+
python ~/.superlocalmemory/memory-profiles.py rename client-acme \
|
|
341
341
|
archived-client-acme-202602
|
|
342
342
|
|
|
343
343
|
# Create fresh profile for new project
|
|
344
|
-
python ~/.
|
|
344
|
+
python ~/.superlocalmemory/memory-profiles.py create client-newco
|
|
345
345
|
```
|
|
346
346
|
|
|
347
347
|
---
|
|
@@ -353,7 +353,7 @@ python ~/.claude-memory/memory-profiles.py create client-newco
|
|
|
353
353
|
### Reset Current Profile Only
|
|
354
354
|
```bash
|
|
355
355
|
# Soft reset active profile
|
|
356
|
-
python ~/.
|
|
356
|
+
python ~/.superlocalmemory/memory-reset.py soft
|
|
357
357
|
|
|
358
358
|
# Active profile cleared, others untouched
|
|
359
359
|
```
|
|
@@ -361,22 +361,22 @@ python ~/.claude-memory/memory-reset.py soft
|
|
|
361
361
|
### Reset Specific Profile
|
|
362
362
|
```bash
|
|
363
363
|
# Switch to profile
|
|
364
|
-
python ~/.
|
|
364
|
+
python ~/.superlocalmemory/memory-profiles.py switch old-project
|
|
365
365
|
|
|
366
366
|
# Reset it
|
|
367
|
-
python ~/.
|
|
367
|
+
python ~/.superlocalmemory/memory-reset.py soft
|
|
368
368
|
|
|
369
369
|
# Switch back
|
|
370
|
-
python ~/.
|
|
370
|
+
python ~/.superlocalmemory/memory-profiles.py switch default
|
|
371
371
|
```
|
|
372
372
|
|
|
373
373
|
### Create Clean Profile
|
|
374
374
|
```bash
|
|
375
375
|
# Create empty profile
|
|
376
|
-
python ~/.
|
|
376
|
+
python ~/.superlocalmemory/memory-profiles.py create clean-slate
|
|
377
377
|
|
|
378
378
|
# Switch to it
|
|
379
|
-
python ~/.
|
|
379
|
+
python ~/.superlocalmemory/memory-profiles.py switch clean-slate
|
|
380
380
|
|
|
381
381
|
# Now work in completely clean environment
|
|
382
382
|
```
|
|
@@ -388,7 +388,7 @@ python ~/.claude-memory/memory-profiles.py switch clean-slate
|
|
|
388
388
|
### "Profile not found"
|
|
389
389
|
Check available profiles:
|
|
390
390
|
```bash
|
|
391
|
-
python ~/.
|
|
391
|
+
python ~/.superlocalmemory/memory-profiles.py list
|
|
392
392
|
```
|
|
393
393
|
|
|
394
394
|
### "Changes not reflecting"
|
|
@@ -401,14 +401,14 @@ Restart Claude CLI after switching profiles:
|
|
|
401
401
|
### "Cannot delete active profile"
|
|
402
402
|
Switch to different profile first:
|
|
403
403
|
```bash
|
|
404
|
-
python ~/.
|
|
405
|
-
python ~/.
|
|
404
|
+
python ~/.superlocalmemory/memory-profiles.py switch default
|
|
405
|
+
python ~/.superlocalmemory/memory-profiles.py delete unwanted
|
|
406
406
|
```
|
|
407
407
|
|
|
408
408
|
### "Profile directory not found"
|
|
409
409
|
Profile will be created on first switch:
|
|
410
410
|
```bash
|
|
411
|
-
python ~/.
|
|
411
|
+
python ~/.superlocalmemory/memory-profiles.py switch new-profile
|
|
412
412
|
# Creates directory automatically
|
|
413
413
|
```
|
|
414
414
|
|
|
@@ -432,7 +432,7 @@ A: Yes. Each profile has its own `config.json`.
|
|
|
432
432
|
A: ~5MB per profile with 100 memories (before compression).
|
|
433
433
|
|
|
434
434
|
**Q: Can I backup all profiles at once?**
|
|
435
|
-
A: Yes, backup `~/.
|
|
435
|
+
A: Yes, backup `~/.superlocalmemory/profiles/` directory.
|
|
436
436
|
|
|
437
437
|
---
|
|
438
438
|
|