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.
Files changed (59) 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/core/engine.py +2 -1
  58. package/src/superlocalmemory/hooks/ide_connector.py +2 -2
  59. package/src/superlocalmemory.egg-info/PKG-INFO +32 -4
@@ -82,7 +82,7 @@ history.clear()
82
82
 
83
83
  ### Storage Details
84
84
 
85
- - Messages persist in `~/.claude-memory/memory.db`
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 `~/.claude-memory/memory.db`
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 ~/.claude-memory
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 ~/.claude-memory/mcp_server.py --transport http --port 8417
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 ~/.claude-memory/mcp_server.py --transport http --port 8001
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 ~/.claude-memory/mcp_server.py --transport http --port 8001
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 ~/.claude-memory/mcp_server.py
613
+ ls -la ~/.superlocalmemory/mcp_server.py
614
614
  ```
615
615
  2. Check permissions:
616
616
  ```bash
617
- chmod +x ~/.claude-memory/mcp_server.py
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 ~/.claude-memory/memory_store_v2.py
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 ~/.claude-memory/mcp_server.py
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 ~/.claude-memory/mcp_server.py
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 ~/.claude-memory/mcp_server.py` to see errors
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 ~/.claude-memory/mcp_server.py
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 ~/.claude-memory
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 ~/.claude-memory/mcp_server.py
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 ~/.claude-memory/mcp_server.py
114
- ls -la ~/.claude-memory/memory_store_v2.py
115
- ls -la ~/.claude-memory/graph_engine.py
116
- ls -la ~/.claude-memory/pattern_learner.py
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 ~/.claude-memory/mcp_server.py
129
- chmod +x ~/.claude-memory/*.py
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 ~/.claude-memory
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 ~/.claude-memory
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 ~/.claude-memory/*.py
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 ~/.claude-memory
320
- PYTHONPATH=~/.claude-memory python3 -c "from memory_store_v2 import MemoryStoreV2; print('OK')"
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 ~/.claude-memory/memory.db
370
+ ls -la ~/.superlocalmemory/memory.db
371
371
 
372
372
  # Check it's not empty
373
- sqlite3 ~/.claude-memory/memory.db "SELECT COUNT(*) FROM memories;"
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
- ~/.claude-memory/memory.db
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 ~/.claude-memory/
393
+ ls -ld ~/.superlocalmemory/
394
394
  # Should NOT be read-only
395
395
 
396
- chmod 755 ~/.claude-memory/
397
- chmod 644 ~/.claude-memory/memory.db
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 ~/.claude-memory/memory.db "PRAGMA integrity_check;"
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 ~/.claude-memory/mcp_server.py 2>&1 | tee /tmp/mcp-debug.log
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 ~/.claude-memory/memory.db
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 ~/.claude-memory/memory.db "PRAGMA integrity_check;"
460
+ sqlite3 ~/.superlocalmemory/memory.db "PRAGMA integrity_check;"
461
461
 
462
462
  # If corrupted, restore from backup
463
- cp ~/.claude-memory/backups/memory.db.backup.* ~/.claude-memory/memory.db
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 ~/.claude-memory`
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 ~/.claude-memory/mcp_server.py`
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 ~/.claude-memory/mcp_server.py`
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 ~/.claude-memory/mcp_server.py
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 ~/.claude-memory && python3 pattern_learner.py update >> pattern_updates.log 2>&1
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 `~/.claude-memory/`
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 ~/.claude-memory/memory-profiles.py list
19
+ python ~/.superlocalmemory/memory-profiles.py list
20
20
  ```
21
21
 
22
22
  ### Show Current Profile
23
23
  ```bash
24
- python ~/.claude-memory/memory-profiles.py current
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 ~/.claude-memory/memory-profiles.py create work \
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 ~/.claude-memory/memory-profiles.py create personal \
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 ~/.claude-memory/memory-profiles.py switch work
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 ~/.claude-memory/memory-profiles.py delete old-profile
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 ~/.claude-memory/memory-profiles.py create work \
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 ~/.claude-memory/memory-profiles.py create personal \
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 ~/.claude-memory/memory-profiles.py switch work # During work hours
84
- python ~/.claude-memory/memory-profiles.py switch personal # Personal time
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 ~/.claude-memory/memory-profiles.py create client-acme \
97
+ python ~/.superlocalmemory/memory-profiles.py create client-acme \
98
98
  --description "Acme Corp project"
99
99
 
100
- python ~/.claude-memory/memory-profiles.py create client-contoso \
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 ~/.claude-memory/memory-profiles.py switch client-acme
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 ~/.claude-memory/memory-profiles.py create experimental \
118
+ python ~/.superlocalmemory/memory-profiles.py create experimental \
119
119
  --description "Testing new features"
120
120
 
121
121
  # Switch to test profile
122
- python ~/.claude-memory/memory-profiles.py switch experimental
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 ~/.claude-memory/memory-profiles.py switch default
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 ~/.claude-memory/memory-profiles.py create architect \
137
+ python ~/.superlocalmemory/memory-profiles.py create architect \
138
138
  --description "Rigorous architecture-first approach"
139
139
 
140
140
  # Rapid prototyper profile
141
- python ~/.claude-memory/memory-profiles.py create prototyper \
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 ~/.claude-memory/memory-profiles.py switch architect # Planning
146
- python ~/.claude-memory/memory-profiles.py switch prototyper # MVP development
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 ~/.claude-memory/memory-profiles.py create new-profile
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 ~/.claude-memory/memory-profiles.py create backup --from-current
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 ~/.claude-memory/memory-profiles.py switch work
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 ~/.claude-memory/profiles/default
197
+ # ✓ Saved to ~/.superlocalmemory/profiles/default
198
198
  # Loading profile 'work'...
199
- # ✓ Loaded from ~/.claude-memory/profiles/work
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 ~/.claude-memory/memory-profiles.py delete old-profile
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 ~/.claude-memory/memory-profiles.py rename old-name new-name
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
- ~/.claude-memory/profiles/
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
- ~/.claude-memory/
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 `~/.claude-memory/profiles.json`:
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 ~/.claude-memory/memory-profiles.py create client-acme-api
302
- python ~/.claude-memory/memory-profiles.py create personal-learning
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 ~/.claude-memory/memory-profiles.py create profile1
306
- python ~/.claude-memory/memory-profiles.py create temp
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 ~/.claude-memory/memory-profiles.py create project-x \
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 ~/.claude-memory/memory-profiles.py switch work
318
+ python ~/.superlocalmemory/memory-profiles.py switch work
319
319
 
320
320
  # End of work day
321
- python ~/.claude-memory/memory-profiles.py switch personal
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 ~/.claude-memory/memory-profiles.py create backup-$(date +%Y%m%d) \
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 ~/.claude-memory/memory-profiles.py switch backup-20260205
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 ~/.claude-memory/memory-profiles.py rename client-acme \
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 ~/.claude-memory/memory-profiles.py create client-newco
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 ~/.claude-memory/memory-reset.py soft
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 ~/.claude-memory/memory-profiles.py switch old-project
364
+ python ~/.superlocalmemory/memory-profiles.py switch old-project
365
365
 
366
366
  # Reset it
367
- python ~/.claude-memory/memory-reset.py soft
367
+ python ~/.superlocalmemory/memory-reset.py soft
368
368
 
369
369
  # Switch back
370
- python ~/.claude-memory/memory-profiles.py switch default
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 ~/.claude-memory/memory-profiles.py create clean-slate
376
+ python ~/.superlocalmemory/memory-profiles.py create clean-slate
377
377
 
378
378
  # Switch to it
379
- python ~/.claude-memory/memory-profiles.py switch clean-slate
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 ~/.claude-memory/memory-profiles.py list
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 ~/.claude-memory/memory-profiles.py switch default
405
- python ~/.claude-memory/memory-profiles.py delete unwanted
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 ~/.claude-memory/memory-profiles.py switch new-profile
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 `~/.claude-memory/profiles/` directory.
435
+ A: Yes, backup `~/.superlocalmemory/profiles/` directory.
436
436
 
437
437
  ---
438
438