superlocalmemory 2.8.1 → 2.8.3
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/ATTRIBUTION.md +50 -0
- package/CHANGELOG.md +8 -0
- package/README.md +31 -20
- package/api_server.py +5 -0
- package/bin/aider-smart +2 -2
- package/bin/slm +18 -18
- package/bin/slm.bat +3 -3
- package/configs/continue-skills.yaml +4 -4
- package/docs/ARCHITECTURE.md +3 -3
- package/docs/CLI-COMMANDS-REFERENCE.md +18 -18
- package/docs/FRAMEWORK-INTEGRATIONS.md +4 -4
- package/docs/SECURITY-QUICK-REFERENCE.md +214 -0
- package/docs/UNIVERSAL-INTEGRATION.md +15 -15
- package/install.ps1 +11 -11
- package/install.sh +4 -4
- package/mcp_server.py +4 -4
- package/package.json +5 -3
- package/requirements-core.txt +16 -18
- package/requirements-learning.txt +8 -8
- package/requirements.txt +9 -7
- package/scripts/prepack.js +33 -0
- package/scripts/verify-v27.ps1 +301 -0
- package/src/agent_registry.py +32 -28
- package/src/auto_backup.py +12 -6
- package/src/cache_manager.py +2 -2
- package/src/compression/__init__.py +25 -0
- package/src/compression/cli.py +150 -0
- package/src/compression/cold_storage.py +217 -0
- package/src/compression/config.py +72 -0
- package/src/compression/orchestrator.py +133 -0
- package/src/compression/tier2_compressor.py +228 -0
- package/src/compression/tier3_compressor.py +153 -0
- package/src/compression/tier_classifier.py +148 -0
- package/src/db_connection_manager.py +5 -5
- package/src/event_bus.py +24 -22
- package/src/graph/graph_core.py +3 -3
- package/src/hnsw_index.py +3 -3
- package/src/learning/__init__.py +5 -4
- package/src/learning/adaptive_ranker.py +14 -265
- package/src/learning/bootstrap/__init__.py +69 -0
- package/src/learning/bootstrap/constants.py +93 -0
- package/src/learning/bootstrap/db_queries.py +316 -0
- package/src/learning/bootstrap/sampling.py +82 -0
- package/src/learning/bootstrap/text_utils.py +71 -0
- package/src/learning/cross_project_aggregator.py +58 -57
- package/src/learning/db/__init__.py +40 -0
- package/src/learning/db/constants.py +44 -0
- package/src/learning/db/schema.py +279 -0
- package/src/learning/learning_db.py +15 -234
- package/src/learning/ranking/__init__.py +33 -0
- package/src/learning/ranking/constants.py +84 -0
- package/src/learning/ranking/helpers.py +278 -0
- package/src/learning/source_quality_scorer.py +66 -65
- package/src/learning/synthetic_bootstrap.py +28 -310
- package/src/memory/__init__.py +36 -0
- package/src/memory/cli.py +205 -0
- package/src/memory/constants.py +39 -0
- package/src/memory/helpers.py +28 -0
- package/src/memory/schema.py +166 -0
- package/src/memory-profiles.py +94 -86
- package/src/memory-reset.py +187 -185
- package/src/memory_compression.py +2 -2
- package/src/memory_store_v2.py +40 -355
- package/src/migrate_v1_to_v2.py +11 -10
- package/src/patterns/analyzers.py +104 -100
- package/src/patterns/learner.py +17 -13
- package/src/patterns/scoring.py +25 -21
- package/src/patterns/store.py +40 -38
- package/src/patterns/terminology.py +53 -51
- package/src/provenance_tracker.py +2 -2
- package/src/qualixar_attribution.py +139 -0
- package/src/qualixar_watermark.py +78 -0
- package/src/search/engine.py +16 -14
- package/src/search/index_loader.py +13 -11
- package/src/setup_validator.py +162 -160
- package/src/subscription_manager.py +20 -18
- package/src/tree/builder.py +66 -64
- package/src/tree/nodes.py +103 -97
- package/src/tree/queries.py +142 -137
- package/src/tree/schema.py +46 -42
- package/src/webhook_dispatcher.py +3 -3
- package/ui_server.py +7 -4
- /package/bin/{superlocalmemoryv2:learning → superlocalmemoryv2-learning} +0 -0
- /package/bin/{superlocalmemoryv2:list → superlocalmemoryv2-list} +0 -0
- /package/bin/{superlocalmemoryv2:patterns → superlocalmemoryv2-patterns} +0 -0
- /package/bin/{superlocalmemoryv2:profile → superlocalmemoryv2-profile} +0 -0
- /package/bin/{superlocalmemoryv2:recall → superlocalmemoryv2-recall} +0 -0
- /package/bin/{superlocalmemoryv2:remember → superlocalmemoryv2-remember} +0 -0
- /package/bin/{superlocalmemoryv2:reset → superlocalmemoryv2-reset} +0 -0
- /package/bin/{superlocalmemoryv2:status → superlocalmemoryv2-status} +0 -0
package/ATTRIBUTION.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Attribution
|
|
2
|
+
|
|
3
|
+
## SuperLocalMemory
|
|
4
|
+
|
|
5
|
+
**SuperLocalMemory** is part of the Qualixar research initiative — advancing agent development through research.
|
|
6
|
+
|
|
7
|
+
### Creator
|
|
8
|
+
|
|
9
|
+
**Varun Pratap Bhardwaj** — Solution Architect & Original Creator
|
|
10
|
+
- GitHub: [@varun369](https://github.com/varun369)
|
|
11
|
+
- ORCID: 0009-0002-8726-4289
|
|
12
|
+
|
|
13
|
+
### License
|
|
14
|
+
|
|
15
|
+
This software is licensed under the MIT License. See [LICENSE](LICENSE) for full terms.
|
|
16
|
+
|
|
17
|
+
### Output Attribution
|
|
18
|
+
|
|
19
|
+
All tool outputs carry provenance metadata:
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
Generated by SuperLocalMemory | Part of Qualixar
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Outputs may include:
|
|
26
|
+
- **Layer 1 (Visible):** Human-readable attribution in reports and exports.
|
|
27
|
+
- **Layer 2 (Cryptographic):** SHA-256 content hash and signature in the `_qualixar` metadata block.
|
|
28
|
+
- **Layer 3 (Steganographic):** Invisible zero-width character watermark in text outputs.
|
|
29
|
+
|
|
30
|
+
### Verification
|
|
31
|
+
|
|
32
|
+
Output provenance can be verified programmatically:
|
|
33
|
+
|
|
34
|
+
```python
|
|
35
|
+
from qualixar_attribution import QualixarSigner
|
|
36
|
+
is_valid = QualixarSigner.verify(signed_output)
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Research Initiative
|
|
40
|
+
|
|
41
|
+
Qualixar is a research platform for AI agent development tools. SuperLocalMemory is one of several research initiatives under the Qualixar umbrella. For more information, visit qualixar.com.
|
|
42
|
+
|
|
43
|
+
### Third-Party Acknowledgments
|
|
44
|
+
|
|
45
|
+
SuperLocalMemory uses the following open-source libraries:
|
|
46
|
+
- scikit-learn (BSD-3-Clause) — TF-IDF vectorization and similarity search
|
|
47
|
+
- SQLite (Public Domain) — Local database storage
|
|
48
|
+
- NumPy (BSD-3-Clause) — Numerical operations
|
|
49
|
+
|
|
50
|
+
See [requirements.txt](requirements.txt) for the full dependency list.
|
package/CHANGELOG.md
CHANGED
|
@@ -16,6 +16,14 @@ SuperLocalMemory V2 - Intelligent local memory system for AI coding assistants.
|
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
19
|
+
## [2.8.2] - 2026-03-04
|
|
20
|
+
|
|
21
|
+
### Fixed
|
|
22
|
+
- Windows compatibility for repository cloning (#7)
|
|
23
|
+
- Updated test assertions for v2.8 behavioral feature dimensions
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
19
27
|
## [2.8.0] - 2026-02-26
|
|
20
28
|
|
|
21
29
|
**Release Type:** Major Feature Release — "Memory That Manages Itself"
|
package/README.md
CHANGED
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
</p>
|
|
15
15
|
|
|
16
16
|
<p align="center">
|
|
17
|
+
<a href="https://arxiv.org/abs/2603.02240"><img src="https://img.shields.io/badge/arXiv-2603.02240-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv"/></a>
|
|
17
18
|
<a href="https://zenodo.org/records/18709670"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.18709670-blue?style=for-the-badge&logo=doi&logoColor=white" alt="DOI"/></a>
|
|
18
19
|
<a href="https://zenodo.org/records/18709670"><img src="https://img.shields.io/badge/Zenodo-Research_Paper-1682D4?style=for-the-badge&logo=zenodo&logoColor=white" alt="Zenodo"/></a>
|
|
19
20
|
<a href="https://www.researchgate.net/publication/400976053"><img src="https://img.shields.io/badge/ResearchGate-Paper-00CCBB?style=for-the-badge&logo=researchgate&logoColor=white" alt="ResearchGate"/></a>
|
|
@@ -38,7 +39,7 @@
|
|
|
38
39
|
</p>
|
|
39
40
|
|
|
40
41
|
<p align="center">
|
|
41
|
-
<b>Created by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a
|
|
42
|
+
<b>A <a href="https://github.com/varun369">Qualixar</a> Product</b> · Created by <a href="https://github.com/varun369">Varun Pratap Bhardwaj</a> •
|
|
42
43
|
<a href="https://github.com/sponsors/varun369">💖 Sponsor</a> •
|
|
43
44
|
<a href="LICENSE">📜 MIT License</a>
|
|
44
45
|
</p>
|
|
@@ -55,21 +56,22 @@ The paper presents SuperLocalMemory's architecture for defending against OWASP A
|
|
|
55
56
|
|
|
56
57
|
| Platform | Link |
|
|
57
58
|
|----------|------|
|
|
59
|
+
| **arXiv** | [arXiv:2603.02240](https://arxiv.org/abs/2603.02240) |
|
|
58
60
|
| **Zenodo** (CERN) | [DOI: 10.5281/zenodo.18709670](https://zenodo.org/records/18709670) |
|
|
59
61
|
| **ResearchGate** | [Publication Page](https://www.researchgate.net/publication/400976053) |
|
|
60
|
-
| **arXiv** | Submission under review |
|
|
61
62
|
| **Research Portfolio** | [superlocalmemory.com/research](https://superlocalmemory.com/research) |
|
|
62
63
|
|
|
63
64
|
If you use SuperLocalMemory in your research, please cite:
|
|
64
65
|
|
|
65
66
|
```bibtex
|
|
66
|
-
@
|
|
67
|
+
@article{bhardwaj2026superlocalmemory,
|
|
67
68
|
title={SuperLocalMemory: Privacy-Preserving Multi-Agent Memory with Bayesian Trust Defense Against Memory Poisoning},
|
|
68
69
|
author={Bhardwaj, Varun Pratap},
|
|
69
70
|
year={2026},
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
71
|
+
eprint={2603.02240},
|
|
72
|
+
archivePrefix={arXiv},
|
|
73
|
+
primaryClass={cs.AI},
|
|
74
|
+
url={https://arxiv.org/abs/2603.02240}
|
|
73
75
|
}
|
|
74
76
|
```
|
|
75
77
|
|
|
@@ -201,10 +203,10 @@ You: *sighs and explains everything again*
|
|
|
201
203
|
npm install -g superlocalmemory
|
|
202
204
|
|
|
203
205
|
# Save a memory
|
|
204
|
-
superlocalmemoryv2
|
|
206
|
+
superlocalmemoryv2-remember "Fixed auth bug - JWT tokens were expiring too fast, increased to 24h"
|
|
205
207
|
|
|
206
208
|
# Later, in a new session...
|
|
207
|
-
superlocalmemoryv2
|
|
209
|
+
superlocalmemoryv2-recall "auth bug"
|
|
208
210
|
# ✓ Found: "Fixed auth bug - JWT tokens were expiring too fast, increased to 24h"
|
|
209
211
|
```
|
|
210
212
|
|
|
@@ -230,7 +232,7 @@ Both methods auto-detect and configure **17+ IDEs and AI tools** — Cursor, VS
|
|
|
230
232
|
### Verify Installation
|
|
231
233
|
|
|
232
234
|
```bash
|
|
233
|
-
superlocalmemoryv2
|
|
235
|
+
superlocalmemoryv2-status
|
|
234
236
|
# ✓ Database: OK (0 memories)
|
|
235
237
|
# ✓ Graph: Ready
|
|
236
238
|
# ✓ Patterns: Ready
|
|
@@ -343,7 +345,7 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
|
|
|
343
345
|
|
|
344
346
|
| Tool | Integration | How It Works |
|
|
345
347
|
|------|-------------|--------------|
|
|
346
|
-
| **Claude Code** | ✅ Skills + MCP | `/superlocalmemoryv2
|
|
348
|
+
| **Claude Code** | ✅ Skills + MCP | `/superlocalmemoryv2-remember` |
|
|
347
349
|
| **Cursor** | ✅ MCP + Skills | AI uses memory tools natively |
|
|
348
350
|
| **Windsurf** | ✅ MCP + Skills | Native memory access |
|
|
349
351
|
| **Claude Desktop** | ✅ MCP | Built-in support |
|
|
@@ -365,7 +367,7 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
|
|
|
365
367
|
- "Remember that we use this framework" just works
|
|
366
368
|
|
|
367
369
|
2. **Skills & Commands** — For Claude Code, Continue.dev, Cody
|
|
368
|
-
- `/superlocalmemoryv2
|
|
370
|
+
- `/superlocalmemoryv2-remember` in Claude Code
|
|
369
371
|
- `/slm-remember` in Continue.dev and Cody
|
|
370
372
|
- Familiar slash command interface
|
|
371
373
|
|
|
@@ -466,15 +468,15 @@ Auto-clustering discovers 6-7 natural topic communities from your memories.
|
|
|
466
468
|
|
|
467
469
|
```bash
|
|
468
470
|
# Memory Operations
|
|
469
|
-
superlocalmemoryv2
|
|
470
|
-
superlocalmemoryv2
|
|
471
|
-
superlocalmemoryv2
|
|
472
|
-
superlocalmemoryv2
|
|
471
|
+
superlocalmemoryv2-remember "content" --tags tag1,tag2 # Save memory
|
|
472
|
+
superlocalmemoryv2-recall "search query" # Search
|
|
473
|
+
superlocalmemoryv2-list # Recent memories
|
|
474
|
+
superlocalmemoryv2-status # System health
|
|
473
475
|
|
|
474
476
|
# Profile Management
|
|
475
|
-
superlocalmemoryv2
|
|
476
|
-
superlocalmemoryv2
|
|
477
|
-
superlocalmemoryv2
|
|
477
|
+
superlocalmemoryv2-profile list # Show all profiles
|
|
478
|
+
superlocalmemoryv2-profile create <name> # New profile
|
|
479
|
+
superlocalmemoryv2-profile switch <name> # Switch context
|
|
478
480
|
|
|
479
481
|
# Knowledge Graph
|
|
480
482
|
python ~/.claude-memory/graph_engine.py build # Build graph
|
|
@@ -544,11 +546,20 @@ MIT License — use freely, even commercially. Just include the license.
|
|
|
544
546
|
|
|
545
547
|
## 👨💻 Author
|
|
546
548
|
|
|
547
|
-
**Varun Pratap Bhardwaj** — Solution Architect
|
|
549
|
+
**Varun Pratap Bhardwaj** — Founder, Qualixar · Solution Architect
|
|
548
550
|
|
|
549
551
|
[](https://github.com/varun369)
|
|
550
552
|
|
|
551
|
-
Building
|
|
553
|
+
Building the complete agent development platform at Qualixar — memory, testing, contracts, and security for AI agents.
|
|
554
|
+
|
|
555
|
+
### Part of the Qualixar Agent Development Platform
|
|
556
|
+
|
|
557
|
+
SuperLocalMemory is part of **Qualixar**, a suite of open-source tools for building reliable AI agents:
|
|
558
|
+
|
|
559
|
+
| Product | What It Does |
|
|
560
|
+
|---------|-------------|
|
|
561
|
+
| **SuperLocalMemory** | Local-first AI agent memory |
|
|
562
|
+
| **SkillFortify** | Agent skill supply chain security |
|
|
552
563
|
|
|
553
564
|
---
|
|
554
565
|
|
package/api_server.py
CHANGED
|
@@ -18,6 +18,8 @@ from fastapi.responses import HTMLResponse, JSONResponse
|
|
|
18
18
|
from pydantic import BaseModel
|
|
19
19
|
import uvicorn
|
|
20
20
|
|
|
21
|
+
from security_middleware import SecurityHeadersMiddleware
|
|
22
|
+
|
|
21
23
|
# Import local modules
|
|
22
24
|
import sys
|
|
23
25
|
sys.path.insert(0, str(Path(__file__).parent / "src"))
|
|
@@ -37,6 +39,9 @@ app = FastAPI(
|
|
|
37
39
|
version="2.0.0"
|
|
38
40
|
)
|
|
39
41
|
|
|
42
|
+
# Security middleware (add first for proper header application)
|
|
43
|
+
app.add_middleware(SecurityHeadersMiddleware)
|
|
44
|
+
|
|
40
45
|
# Mount static files
|
|
41
46
|
UI_DIR.mkdir(exist_ok=True)
|
|
42
47
|
app.mount("/static", StaticFiles(directory=str(UI_DIR)), name="static")
|
package/bin/aider-smart
CHANGED
|
@@ -35,11 +35,11 @@ echo ""
|
|
|
35
35
|
if command -v slm &> /dev/null; then
|
|
36
36
|
# Use slm command if available
|
|
37
37
|
slm context > "$CONTEXT_FILE" 2>/dev/null || {
|
|
38
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
38
|
+
"$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5 > "$CONTEXT_FILE" 2>/dev/null || true
|
|
39
39
|
}
|
|
40
40
|
else
|
|
41
41
|
# Fallback to direct command
|
|
42
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
42
|
+
"$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5 > "$CONTEXT_FILE" 2>/dev/null || true
|
|
43
43
|
fi
|
|
44
44
|
|
|
45
45
|
# Get coding patterns if available
|
package/bin/slm
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
# Licensed under MIT License
|
|
7
7
|
#
|
|
8
8
|
# This is a CONVENIENCE wrapper. Original commands still work:
|
|
9
|
-
# superlocalmemoryv2
|
|
9
|
+
# superlocalmemoryv2-remember, superlocalmemoryv2-recall, etc.
|
|
10
10
|
|
|
11
11
|
set -e
|
|
12
12
|
|
|
@@ -24,13 +24,13 @@ case "$1" in
|
|
|
24
24
|
remember|save|store)
|
|
25
25
|
shift
|
|
26
26
|
# Calls existing command - no duplicate logic
|
|
27
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
27
|
+
"$SLM_DIR/bin/superlocalmemoryv2-remember" "$@"
|
|
28
28
|
;;
|
|
29
29
|
|
|
30
30
|
recall|search|find)
|
|
31
31
|
shift
|
|
32
32
|
# Calls existing command - no duplicate logic
|
|
33
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
33
|
+
"$SLM_DIR/bin/superlocalmemoryv2-recall" "$@"
|
|
34
34
|
;;
|
|
35
35
|
|
|
36
36
|
list|ls)
|
|
@@ -38,44 +38,44 @@ case "$1" in
|
|
|
38
38
|
# Convert positional number to --limit flag
|
|
39
39
|
# e.g., "slm list 5" becomes "--limit 5"
|
|
40
40
|
if [ -n "$1" ] && [[ "$1" =~ ^[0-9]+$ ]]; then
|
|
41
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
41
|
+
"$SLM_DIR/bin/superlocalmemoryv2-list" --limit "$1"
|
|
42
42
|
else
|
|
43
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
43
|
+
"$SLM_DIR/bin/superlocalmemoryv2-list" "$@"
|
|
44
44
|
fi
|
|
45
45
|
;;
|
|
46
46
|
|
|
47
47
|
status|info|stats)
|
|
48
48
|
# Calls existing command - no duplicate logic
|
|
49
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
49
|
+
"$SLM_DIR/bin/superlocalmemoryv2-status"
|
|
50
50
|
;;
|
|
51
51
|
|
|
52
52
|
profile)
|
|
53
53
|
shift
|
|
54
54
|
# Calls existing command - no duplicate logic
|
|
55
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
55
|
+
"$SLM_DIR/bin/superlocalmemoryv2-profile" "$@"
|
|
56
56
|
;;
|
|
57
57
|
|
|
58
58
|
switch-profile)
|
|
59
59
|
shift
|
|
60
60
|
# Convenience alias: "slm switch-profile <name>" -> "slm profile switch <name>"
|
|
61
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
61
|
+
"$SLM_DIR/bin/superlocalmemoryv2-profile" switch "$@"
|
|
62
62
|
;;
|
|
63
63
|
|
|
64
64
|
list-profiles)
|
|
65
65
|
# Convenience alias: "slm list-profiles" -> "slm profile list"
|
|
66
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
66
|
+
"$SLM_DIR/bin/superlocalmemoryv2-profile" list
|
|
67
67
|
;;
|
|
68
68
|
|
|
69
69
|
create-profile)
|
|
70
70
|
shift
|
|
71
71
|
# Convenience alias: "slm create-profile <name>" -> "slm profile create <name>"
|
|
72
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
72
|
+
"$SLM_DIR/bin/superlocalmemoryv2-profile" create "$@"
|
|
73
73
|
;;
|
|
74
74
|
|
|
75
75
|
reset)
|
|
76
76
|
shift
|
|
77
77
|
# Calls existing command - no duplicate logic
|
|
78
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
78
|
+
"$SLM_DIR/bin/superlocalmemoryv2-reset" "$@"
|
|
79
79
|
;;
|
|
80
80
|
|
|
81
81
|
ui|dashboard)
|
|
@@ -103,7 +103,7 @@ case "$1" in
|
|
|
103
103
|
context)
|
|
104
104
|
# NEW: Get context for current directory/project
|
|
105
105
|
project=$(basename "$PWD")
|
|
106
|
-
"$SLM_DIR/bin/superlocalmemoryv2
|
|
106
|
+
"$SLM_DIR/bin/superlocalmemoryv2-recall" "$project" --limit 5
|
|
107
107
|
;;
|
|
108
108
|
|
|
109
109
|
graph)
|
|
@@ -361,12 +361,12 @@ ADVANCED:
|
|
|
361
361
|
slm reset hard --confirm Hard reset (nuclear option)
|
|
362
362
|
|
|
363
363
|
ORIGINAL COMMANDS (still work):
|
|
364
|
-
superlocalmemoryv2
|
|
365
|
-
superlocalmemoryv2
|
|
366
|
-
superlocalmemoryv2
|
|
367
|
-
superlocalmemoryv2
|
|
368
|
-
superlocalmemoryv2
|
|
369
|
-
superlocalmemoryv2
|
|
364
|
+
superlocalmemoryv2-remember <content>
|
|
365
|
+
superlocalmemoryv2-recall <query>
|
|
366
|
+
superlocalmemoryv2-list [N]
|
|
367
|
+
superlocalmemoryv2-status
|
|
368
|
+
superlocalmemoryv2-profile <command>
|
|
369
|
+
superlocalmemoryv2-reset <type>
|
|
370
370
|
|
|
371
371
|
EXAMPLES:
|
|
372
372
|
slm remember "Use FastAPI for REST APIs" --tags python,backend
|
package/bin/slm.bat
CHANGED
|
@@ -49,7 +49,7 @@ exit /b 1
|
|
|
49
49
|
|
|
50
50
|
REM Parse command
|
|
51
51
|
if "%1"=="" (
|
|
52
|
-
echo SuperLocalMemory
|
|
52
|
+
echo SuperLocalMemory - Universal AI Memory System
|
|
53
53
|
echo.
|
|
54
54
|
echo Usage: slm [command] [options]
|
|
55
55
|
echo.
|
|
@@ -145,7 +145,7 @@ if exist "%INSTALL_DIR%\memory-profiles.py" (
|
|
|
145
145
|
exit /b %ERRORLEVEL%
|
|
146
146
|
|
|
147
147
|
:show_help
|
|
148
|
-
echo SuperLocalMemory
|
|
148
|
+
echo SuperLocalMemory - Universal AI Memory System
|
|
149
149
|
echo.
|
|
150
150
|
echo Usage: slm [command] [options]
|
|
151
151
|
echo.
|
|
@@ -188,7 +188,7 @@ echo Report issues: https://github.com/varun369/SuperLocalMemoryV2/issues
|
|
|
188
188
|
exit /b 0
|
|
189
189
|
|
|
190
190
|
:show_version
|
|
191
|
-
echo SuperLocalMemory V2.
|
|
191
|
+
echo SuperLocalMemory V2.8.3
|
|
192
192
|
echo Copyright (c) 2026 Varun Pratap Bhardwaj
|
|
193
193
|
echo Licensed under MIT License
|
|
194
194
|
echo Repository: https://github.com/varun369/SuperLocalMemoryV2
|
|
@@ -5,19 +5,19 @@
|
|
|
5
5
|
slashCommands:
|
|
6
6
|
- name: "slm-remember"
|
|
7
7
|
description: "Save to SuperLocalMemory"
|
|
8
|
-
run: "~/.claude-memory/bin/superlocalmemoryv2
|
|
8
|
+
run: "~/.claude-memory/bin/superlocalmemoryv2-remember \"{{input}}\""
|
|
9
9
|
|
|
10
10
|
- name: "slm-recall"
|
|
11
11
|
description: "Search SuperLocalMemory"
|
|
12
|
-
run: "~/.claude-memory/bin/superlocalmemoryv2
|
|
12
|
+
run: "~/.claude-memory/bin/superlocalmemoryv2-recall \"{{input}}\""
|
|
13
13
|
|
|
14
14
|
- name: "slm-list"
|
|
15
15
|
description: "List recent memories"
|
|
16
|
-
run: "~/.claude-memory/bin/superlocalmemoryv2
|
|
16
|
+
run: "~/.claude-memory/bin/superlocalmemoryv2-list"
|
|
17
17
|
|
|
18
18
|
- name: "slm-status"
|
|
19
19
|
description: "SuperLocalMemory system status"
|
|
20
|
-
run: "~/.claude-memory/bin/superlocalmemoryv2
|
|
20
|
+
run: "~/.claude-memory/bin/superlocalmemoryv2-status"
|
|
21
21
|
|
|
22
22
|
# Usage in Continue.dev:
|
|
23
23
|
# /slm-remember Use FastAPI for REST APIs
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -61,7 +61,7 @@ Simple Storage → Intelligent Organization → Adaptive Learning
|
|
|
61
61
|
│ • Continue.dev - MCP context providers │
|
|
62
62
|
├─────────────────────────────────────────────────────────────┤
|
|
63
63
|
│ TIER 2: Skills & Commands │
|
|
64
|
-
│ • Claude Code - /superlocalmemoryv2
|
|
64
|
+
│ • Claude Code - /superlocalmemoryv2-* │
|
|
65
65
|
│ • Continue.dev - /slm-* slash commands │
|
|
66
66
|
│ • Cody - Custom commands via settings │
|
|
67
67
|
├─────────────────────────────────────────────────────────────┤
|
|
@@ -148,8 +148,8 @@ Installation automatically detects and configures:
|
|
|
148
148
|
Provides simple syntax for all operations:
|
|
149
149
|
|
|
150
150
|
```bash
|
|
151
|
-
slm remember "content" # Calls superlocalmemoryv2
|
|
152
|
-
slm recall "query" # Calls superlocalmemoryv2
|
|
151
|
+
slm remember "content" # Calls superlocalmemoryv2-remember
|
|
152
|
+
slm recall "query" # Calls superlocalmemoryv2-recall
|
|
153
153
|
slm list # Recent memories
|
|
154
154
|
slm status # System health
|
|
155
155
|
slm profile list # Profile management
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
SuperLocalMemory V2 offers three access methods:
|
|
8
8
|
1. **Universal CLI** - Simple `slm` commands (NEW in v2.1.0)
|
|
9
|
-
2. **Original CLI** - Full `superlocalmemoryv2
|
|
9
|
+
2. **Original CLI** - Full `superlocalmemoryv2-*` commands
|
|
10
10
|
3. **MCP/Skills** - IDE-specific integration (auto-configured)
|
|
11
11
|
|
|
12
12
|
All methods use the same local SQLite database.
|
|
@@ -105,9 +105,9 @@ All original commands continue to work unchanged. Use these if you prefer explic
|
|
|
105
105
|
|
|
106
106
|
### Check System Status
|
|
107
107
|
```bash
|
|
108
|
-
superlocalmemoryv2
|
|
108
|
+
superlocalmemoryv2-status
|
|
109
109
|
# OR
|
|
110
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
110
|
+
~/.claude-memory/bin/superlocalmemoryv2-status
|
|
111
111
|
```
|
|
112
112
|
Shows: total memories, graph stats, clusters, patterns, database size
|
|
113
113
|
|
|
@@ -119,38 +119,38 @@ Shows: total memories, graph stats, clusters, patterns, database size
|
|
|
119
119
|
|
|
120
120
|
### List All Profiles
|
|
121
121
|
```bash
|
|
122
|
-
superlocalmemoryv2
|
|
122
|
+
superlocalmemoryv2-profile list
|
|
123
123
|
# OR
|
|
124
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
124
|
+
~/.claude-memory/bin/superlocalmemoryv2-profile list
|
|
125
125
|
```
|
|
126
126
|
Shows all profiles with active marker (→)
|
|
127
127
|
|
|
128
128
|
### Show Current Active Profile
|
|
129
129
|
```bash
|
|
130
|
-
superlocalmemoryv2
|
|
130
|
+
superlocalmemoryv2-profile current
|
|
131
131
|
# OR
|
|
132
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
132
|
+
~/.claude-memory/bin/superlocalmemoryv2-profile current
|
|
133
133
|
```
|
|
134
134
|
Shows current profile details and memory count
|
|
135
135
|
|
|
136
136
|
### Create New Profile
|
|
137
137
|
```bash
|
|
138
138
|
# Empty profile
|
|
139
|
-
superlocalmemoryv2
|
|
139
|
+
superlocalmemoryv2-profile create work --description "Work projects"
|
|
140
140
|
|
|
141
141
|
# Copy from current profile
|
|
142
|
-
superlocalmemoryv2
|
|
142
|
+
superlocalmemoryv2-profile create personal --from-current
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
### Switch Profile
|
|
146
146
|
```bash
|
|
147
|
-
superlocalmemoryv2
|
|
147
|
+
superlocalmemoryv2-profile switch work
|
|
148
148
|
```
|
|
149
149
|
**⚠️ Restart your IDE after switching if using MCP integration.**
|
|
150
150
|
|
|
151
151
|
### Delete Profile
|
|
152
152
|
```bash
|
|
153
|
-
superlocalmemoryv2
|
|
153
|
+
superlocalmemoryv2-profile delete old-project
|
|
154
154
|
```
|
|
155
155
|
- Cannot delete "default" profile
|
|
156
156
|
- Cannot delete currently active profile
|
|
@@ -165,15 +165,15 @@ superlocalmemoryv2:profile delete old-project
|
|
|
165
165
|
```bash
|
|
166
166
|
slm status
|
|
167
167
|
# OR
|
|
168
|
-
superlocalmemoryv2
|
|
168
|
+
superlocalmemoryv2-status
|
|
169
169
|
```
|
|
170
170
|
**Always check status before any reset operation!**
|
|
171
171
|
|
|
172
172
|
### Soft Reset
|
|
173
173
|
```bash
|
|
174
|
-
superlocalmemoryv2
|
|
174
|
+
superlocalmemoryv2-reset soft
|
|
175
175
|
# OR
|
|
176
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
176
|
+
~/.claude-memory/bin/superlocalmemoryv2-reset soft
|
|
177
177
|
```
|
|
178
178
|
- Clears all memories from current profile
|
|
179
179
|
- Clears graph, patterns, tree structure
|
|
@@ -183,9 +183,9 @@ superlocalmemoryv2:reset soft
|
|
|
183
183
|
|
|
184
184
|
### Hard Reset
|
|
185
185
|
```bash
|
|
186
|
-
superlocalmemoryv2
|
|
186
|
+
superlocalmemoryv2-reset hard --confirm
|
|
187
187
|
# OR
|
|
188
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
188
|
+
~/.claude-memory/bin/superlocalmemoryv2-reset hard --confirm
|
|
189
189
|
```
|
|
190
190
|
- ⚠️ **NUCLEAR OPTION** ⚠️
|
|
191
191
|
- Deletes entire database file
|
|
@@ -195,9 +195,9 @@ superlocalmemoryv2:reset hard --confirm
|
|
|
195
195
|
|
|
196
196
|
### Layer Reset (Surgical)
|
|
197
197
|
```bash
|
|
198
|
-
superlocalmemoryv2
|
|
198
|
+
superlocalmemoryv2-reset layer --layers graph patterns
|
|
199
199
|
# OR
|
|
200
|
-
~/.claude-memory/bin/superlocalmemoryv2
|
|
200
|
+
~/.claude-memory/bin/superlocalmemoryv2-reset layer --layers graph patterns
|
|
201
201
|
```
|
|
202
202
|
Available layers:
|
|
203
203
|
- `graph` - Clear graph nodes, edges, clusters
|
|
@@ -240,7 +240,7 @@ history.clear()
|
|
|
240
240
|
chat_store.delete_messages("user-1")
|
|
241
241
|
|
|
242
242
|
# CLI: Reset entire profile
|
|
243
|
-
# superlocalmemoryv2
|
|
243
|
+
# superlocalmemoryv2-reset soft --profile customer-support
|
|
244
244
|
```
|
|
245
245
|
|
|
246
246
|
---
|
|
@@ -265,7 +265,7 @@ If you see "database is locked" errors:
|
|
|
265
265
|
|
|
266
266
|
```bash
|
|
267
267
|
# Check if SuperLocalMemory is running correctly
|
|
268
|
-
superlocalmemoryv2
|
|
268
|
+
superlocalmemoryv2-status
|
|
269
269
|
|
|
270
270
|
# Restart any MCP servers
|
|
271
271
|
# (Close and reopen Cursor/Windsurf)
|
|
@@ -277,10 +277,10 @@ If a profile doesn't exist:
|
|
|
277
277
|
|
|
278
278
|
```bash
|
|
279
279
|
# List available profiles
|
|
280
|
-
superlocalmemoryv2
|
|
280
|
+
superlocalmemoryv2-profile list
|
|
281
281
|
|
|
282
282
|
# Create the profile
|
|
283
|
-
superlocalmemoryv2
|
|
283
|
+
superlocalmemoryv2-profile create work
|
|
284
284
|
```
|
|
285
285
|
|
|
286
286
|
---
|