superlocalmemory 4.2.0 → 4.2.2
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/.claude-plugin/marketplace.json +2 -2
- package/CHANGELOG.md +90 -0
- package/README.md +40 -9
- package/antigravity-plugin/_GENERATED.md +1 -1
- package/antigravity-plugin/agents/slm-governance-advisor.md +1 -1
- package/antigravity-plugin/agents/slm-loop-runner.md +1 -1
- package/antigravity-plugin/agents/slm-memory-advisor.md +1 -1
- package/antigravity-plugin/agents/slm-optimize-advisor.md +1 -1
- package/antigravity-plugin/plugin.json +1 -1
- package/antigravity-plugin/skills/slm-bot-memory/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-cache/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-compress/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-governance/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-graph/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-loop/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-media/SKILL.md +10 -4
- package/antigravity-plugin/skills/slm-mesh/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-profile/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-recall/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-remember/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-scope/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-session/SKILL.md +1 -1
- package/antigravity-plugin/skills/slm-status/SKILL.md +1 -1
- package/codex-plugin/.claude-plugin/plugin.json +1 -1
- package/codex-plugin/.codex-plugin/plugin.json +1 -1
- package/codex-plugin/AGENTS.md +1 -1
- package/codex-plugin/README.md +2 -2
- package/codex-plugin/_GENERATED.md +1 -1
- package/codex-plugin/agents/slm-governance-advisor.md +1 -1
- package/codex-plugin/agents/slm-loop-runner.md +1 -1
- package/codex-plugin/agents/slm-memory-advisor.md +1 -1
- package/codex-plugin/agents/slm-optimize-advisor.md +1 -1
- package/codex-plugin/skills/slm-bot-memory/SKILL.md +1 -1
- package/codex-plugin/skills/slm-cache/SKILL.md +1 -1
- package/codex-plugin/skills/slm-compress/SKILL.md +1 -1
- package/codex-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
- package/codex-plugin/skills/slm-governance/SKILL.md +1 -1
- package/codex-plugin/skills/slm-graph/SKILL.md +1 -1
- package/codex-plugin/skills/slm-loop/SKILL.md +1 -1
- package/codex-plugin/skills/slm-media/SKILL.md +10 -4
- package/codex-plugin/skills/slm-mesh/SKILL.md +1 -1
- package/codex-plugin/skills/slm-profile/SKILL.md +1 -1
- package/codex-plugin/skills/slm-recall/SKILL.md +1 -1
- package/codex-plugin/skills/slm-remember/SKILL.md +1 -1
- package/codex-plugin/skills/slm-scope/SKILL.md +1 -1
- package/codex-plugin/skills/slm-session/SKILL.md +1 -1
- package/codex-plugin/skills/slm-status/SKILL.md +1 -1
- package/copilot-plugin/.github/agents/slm-governance-advisor.agent.md +2 -2
- package/copilot-plugin/.github/agents/slm-loop-runner.agent.md +2 -2
- package/copilot-plugin/.github/agents/slm-memory-advisor.agent.md +2 -2
- package/copilot-plugin/.github/agents/slm-optimize-advisor.agent.md +2 -2
- package/copilot-plugin/.github/copilot-instructions.md +4 -4
- package/copilot-plugin/.github/prompts/slm-bot-memory.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-cache.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-compress.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-getting-started-bot.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-governance.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-graph.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-loop.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-media.prompt.md +11 -5
- package/copilot-plugin/.github/prompts/slm-mesh.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-profile.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-recall.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-remember.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-scope.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-session.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-status.prompt.md +2 -2
- package/copilot-plugin/.github/prompts/slm-web-access.prompt.md +1 -1
- package/copilot-plugin/README.md +2 -2
- package/copilot-plugin/_GENERATED.md +1 -1
- package/hermes-plugin/__init__.py +7 -6
- package/hermes-plugin/agents/slm-governance-advisor.md +1 -1
- package/hermes-plugin/agents/slm-loop-runner.md +1 -1
- package/hermes-plugin/agents/slm-memory-advisor.md +1 -1
- package/hermes-plugin/agents/slm-optimize-advisor.md +1 -1
- package/hermes-plugin/plugin.yaml +1 -1
- package/hermes-plugin/remote.py +25 -4
- package/hermes-plugin/skills/slm-bot-memory/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-cache/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-compress/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-governance/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-graph/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-loop/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-media/SKILL.md +10 -4
- package/hermes-plugin/skills/slm-mesh/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-profile/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-recall/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-remember/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-scope/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-session/SKILL.md +1 -1
- package/hermes-plugin/skills/slm-status/SKILL.md +1 -1
- package/package.json +1 -1
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/.cursor-plugin/plugin.json +1 -1
- package/plugin/CLAUDE.md +3 -3
- package/plugin/agents/slm-governance-advisor.md +1 -1
- package/plugin/agents/slm-loop-runner.md +1 -1
- package/plugin/agents/slm-memory-advisor.md +1 -1
- package/plugin/agents/slm-optimize-advisor.md +1 -1
- package/plugin/cursor-skills/slm-bot-memory/SKILL.md +1 -1
- package/plugin/cursor-skills/slm-getting-started-bot/SKILL.md +1 -1
- package/plugin/cursor-skills/slm-recall/SKILL.md +1 -1
- package/plugin/cursor-skills/slm-remember/SKILL.md +1 -1
- package/plugin/cursor-skills/slm-scope/SKILL.md +1 -1
- package/plugin/cursor-skills/slm-session/SKILL.md +1 -1
- package/plugin/mcp.cursor.json +1 -1
- package/plugin/requirements.txt +1 -1
- package/plugin/skills/slm-bot-memory/SKILL.md +1 -1
- package/plugin/skills/slm-cache/SKILL.md +1 -1
- package/plugin/skills/slm-compress/SKILL.md +1 -1
- package/plugin/skills/slm-getting-started-bot/SKILL.md +1 -1
- package/plugin/skills/slm-governance/SKILL.md +1 -1
- package/plugin/skills/slm-graph/SKILL.md +1 -1
- package/plugin/skills/slm-loop/SKILL.md +1 -1
- package/plugin/skills/slm-media/SKILL.md +10 -4
- package/plugin/skills/slm-mesh/SKILL.md +1 -1
- package/plugin/skills/slm-profile/SKILL.md +1 -1
- package/plugin/skills/slm-recall/SKILL.md +1 -1
- package/plugin/skills/slm-remember/SKILL.md +1 -1
- package/plugin/skills/slm-scope/SKILL.md +1 -1
- package/plugin/skills/slm-session/SKILL.md +1 -1
- package/plugin/skills/slm-status/SKILL.md +1 -1
- package/plugin-src/agents/slm-governance-advisor.md +1 -1
- package/plugin-src/agents/slm-loop-runner.md +1 -1
- package/plugin-src/agents/slm-memory-advisor.md +1 -1
- package/plugin-src/agents/slm-optimize-advisor.md +1 -1
- package/plugin-src/rules/AGENTS.md +1 -1
- package/plugin-src/rules/CLAUDE.md.fragment +3 -3
- package/plugin-src/skills/slm-bot-memory/SKILL.md +1 -1
- package/plugin-src/skills/slm-cache/SKILL.md +1 -1
- package/plugin-src/skills/slm-compress/SKILL.md +1 -1
- package/plugin-src/skills/slm-getting-started-bot/SKILL.md +1 -1
- package/plugin-src/skills/slm-governance/SKILL.md +1 -1
- package/plugin-src/skills/slm-graph/SKILL.md +1 -1
- package/plugin-src/skills/slm-loop/SKILL.md +1 -1
- package/plugin-src/skills/slm-media/SKILL.md +10 -4
- package/plugin-src/skills/slm-mesh/SKILL.md +1 -1
- package/plugin-src/skills/slm-profile/SKILL.md +1 -1
- package/plugin-src/skills/slm-recall/SKILL.md +1 -1
- package/plugin-src/skills/slm-remember/SKILL.md +1 -1
- package/plugin-src/skills/slm-scope/SKILL.md +1 -1
- package/plugin-src/skills/slm-session/SKILL.md +1 -1
- package/plugin-src/skills/slm-status/SKILL.md +1 -1
- package/scripts/postinstall.js +4 -2
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"license": "AGPL-3.0-or-later",
|
|
22
22
|
"name": "superlocalmemory",
|
|
23
23
|
"source": "./plugin",
|
|
24
|
-
"version": "4.2.
|
|
24
|
+
"version": "4.2.2"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"author": {
|
|
@@ -39,7 +39,7 @@
|
|
|
39
39
|
"license": "AGPL-3.0-or-later",
|
|
40
40
|
"name": "superlocalmemory-codex",
|
|
41
41
|
"source": "./codex-plugin",
|
|
42
|
-
"version": "4.2.
|
|
42
|
+
"version": "4.2.2"
|
|
43
43
|
}
|
|
44
44
|
]
|
|
45
45
|
}
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,96 @@ All notable changes to SuperLocalMemory will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [4.2.2] — Recall never refuses answers it has after a model change, and "What am I working on?" answers from your work
|
|
9
|
+
|
|
10
|
+
A fix release. Upgrading never moves or deletes memory. Text stays on the model it uses today.
|
|
11
|
+
|
|
12
|
+
### Fixes
|
|
13
|
+
|
|
14
|
+
- **Moving text to the newer memory engine could make recall refuse answers it had.**
|
|
15
|
+
Recall decides "this is in your memory" with a check fitted on one text model
|
|
16
|
+
(nomic). After "Upgrade memory engine" (the Settings card, or `slm embedder upgrade`)
|
|
17
|
+
moved text to EmbeddingGemma 2, that check scored correct memories far
|
|
18
|
+
below its bar, and recall said "That isn't in SuperLocalMemory" to questions it
|
|
19
|
+
had answered before. The check is now chosen by the text model in use, and
|
|
20
|
+
SuperLocalMemory no longer moves text to a model the check was not fitted for,
|
|
21
|
+
whichever way it is asked (the Settings card, the embedding picker, the config file,
|
|
22
|
+
the CLI or MCP); only `slm embedder switch --force` does. Measured on the release harness (a synthetic store): with the old check, EmbeddingGemma 2 refused all 203 real questions. A check fitted for it found every real answer on questions it had not seen, but also answered questions with no answer (it refused 69% of made-up questions; nomic refuses 98.5%), so it is not used: text stays on nomic, and Gemma keeps serving pictures and documents.
|
|
23
|
+
- **Two models, one memory.** Text is searched with the text model (nomic); if you
|
|
24
|
+
turn on pictures and documents, EmbeddingGemma 2 reads those, and one recall returns
|
|
25
|
+
both. The picture model unloads after 30 minutes unused. "Upgrade memory engine" is
|
|
26
|
+
no longer offered: the Settings card now appears only for a store whose text already
|
|
27
|
+
moved, the npm installer no longer offers it, and `slm embedder upgrade` is hidden.
|
|
28
|
+
- **Install, three ways, the same result.** The README now has a prompt to paste into
|
|
29
|
+
any agent (Claude Code, Codex, Cursor, …), and the npm and pip commands. The agent
|
|
30
|
+
setup steps ask the person one question, whether to turn on pictures and documents,
|
|
31
|
+
and `npm install -g superlocalmemory --media` turns them on from the start.
|
|
32
|
+
- **If your text already moved,** the Settings card, `slm doctor` (new check
|
|
33
|
+
"Answer check fit") and the MCP `health` tool say so and how to go back: Roll back on the card, or
|
|
34
|
+
`slm embedder rollback`. Your previous vectors are kept, so it takes minutes, and
|
|
35
|
+
the rollback message now says that instead of promising a full re-index.
|
|
36
|
+
- **A model switch kept its hub baselines.** Each memory carries a baseline that
|
|
37
|
+
stops a few "close to everything" memories from looking like answers. A switch
|
|
38
|
+
renamed the vector columns, a trigger followed the old column, and the clean-up
|
|
39
|
+
afterwards deleted every baseline (27,236 to 0 on one store). The trigger is now
|
|
40
|
+
re-bound on every switch, a store an earlier switch damaged is repaired by itself,
|
|
41
|
+
and the new model's baselines are measured before the switch finishes.
|
|
42
|
+
- **`slm embedder calibrate` works on a real install.** It stopped on two settings
|
|
43
|
+
that only its own tests had (`config.profile_id`, `RetrievalEngine._channels`). It
|
|
44
|
+
is now tested against a real engine, and a test checks every setting it reads
|
|
45
|
+
exists.
|
|
46
|
+
- **"What am I working on?" answers from your work.** The newest rows on a busy
|
|
47
|
+
store were the hooks' own bookkeeping ("[project] session ended …",
|
|
48
|
+
"File changed: …", "files: …") and the prompts you typed to an agent, so they
|
|
49
|
+
won a question about the present. Bookkeeping is now recognised in all its shapes,
|
|
50
|
+
flagged when it is saved, and the rows already stored are flagged once on upgrade
|
|
51
|
+
(nothing deleted; they stay listable). Your captured prompts stay searchable but
|
|
52
|
+
rank as requests: below what you and your agents saved, and never as the answer
|
|
53
|
+
to "what am I working on?". Ask "what did I ask for…" and they come back first.
|
|
54
|
+
|
|
55
|
+
### Upgrading
|
|
56
|
+
|
|
57
|
+
- The store's schema version moves to 62 (a data repair, no new table). Going back
|
|
58
|
+
to 4.2.1 needs `slm db prepare-downgrade` first, as for earlier releases.
|
|
59
|
+
|
|
60
|
+
## [4.2.1] — Each person sees only their own workspace, and moving to the newer memory engine finishes
|
|
61
|
+
|
|
62
|
+
A fix release. Upgrading never moves or deletes memory.
|
|
63
|
+
|
|
64
|
+
### Security
|
|
65
|
+
|
|
66
|
+
- **Recall Lab, Memories search and memory chat stay in the signed-in person's
|
|
67
|
+
workspace.** These three dashboard requests checked that a signed-in person could
|
|
68
|
+
read their workspace, then searched the machine's active workspace instead. With
|
|
69
|
+
more than one workspace, someone signed in to one could read another's memories.
|
|
70
|
+
They now search only the workspace that was checked, and a test signs in two people
|
|
71
|
+
in two workspaces and fails if either sees the other's memories. Saved views, the
|
|
72
|
+
REST `/recall` route, MCP and the CLI were not affected.
|
|
73
|
+
|
|
74
|
+
### Fixes
|
|
75
|
+
|
|
76
|
+
- **Moving to the newer memory engine no longer stops at a long memory.** A memory
|
|
77
|
+
over 8,000 characters made the EmbeddingGemma 2 worker refuse its batch, and the
|
|
78
|
+
whole re-index stopped. It is now embedded from its start (the model reads about
|
|
79
|
+
that much anyway), the same way the previous engine handled it.
|
|
80
|
+
- **Hermes plugin keeps working after an SLM upgrade.** It refused every `/slm`
|
|
81
|
+
command unless SLM was exactly the release it shipped with. It now works with that
|
|
82
|
+
release and every newer one of the same major version, and its message says how to
|
|
83
|
+
move a pinned plugin ([Hermes](docs/hermes.md#upgrade)).
|
|
84
|
+
- **Recall Lab:** clicking a result opens the whole memory, not the shortened text.
|
|
85
|
+
- **Dashboard:** a source opened from "Ask your memory" opens that memory in the
|
|
86
|
+
Memories tab. Settings no longer comes up blank after moving between panes.
|
|
87
|
+
- **Choose folder:** while remote access is on, folders cannot be connected; the page
|
|
88
|
+
now says so next to the button before anyone clicks, instead of after a click below
|
|
89
|
+
the fold.
|
|
90
|
+
- **Sign-in:** when every person must sign in (company mode), a signed-out visitor
|
|
91
|
+
gets one sign-in screen instead of panes that never load, and a signed-in person
|
|
92
|
+
sees who they are, their role and workspace, with Sign out. On a personal computer
|
|
93
|
+
nothing changes: the owner never signs in. Governance says so plainly, and the first
|
|
94
|
+
person you add starts as an admin. There is no default account or password.
|
|
95
|
+
- **README:** the product film follows the twelve superpowers; the architecture
|
|
96
|
+
diagram is redrawn.
|
|
97
|
+
|
|
8
98
|
## [4.2.0] — Recall that says "That isn't in SuperLocalMemory", memory that looks after itself, pictures and documents
|
|
9
99
|
|
|
10
100
|
This release changes what recall does when memory cannot answer, adds a Memory
|
package/README.md
CHANGED
|
@@ -24,10 +24,6 @@
|
|
|
24
24
|
<img src="https://raw.githubusercontent.com/qualixar/superlocalmemory/main/docs/assets/gifs/recall-tiers.gif" alt="Recall in the dashboard: a real question gets its answer; a gibberish question gets 'That isn't in SuperLocalMemory.'; a real question memory cannot answer exactly gets the closest memories, labelled" width="820">
|
|
25
25
|
|
|
26
26
|
|
|
27
|
-
### Watch the four-minute product film
|
|
28
|
-
|
|
29
|
-
[](https://www.youtube.com/watch?v=pyAu_vaIYZQ)
|
|
30
|
-
|
|
31
27
|
</div>
|
|
32
28
|
|
|
33
29
|
**Agents forget everything between sessions. The usual fix — a vector store with a save button — makes it worse:** it always returns *something*, even when nothing it holds answers the question, and your agent builds on it. This is a memory **brain**, not a bucket: it understands what was saved (who, what, when, which project), keeps it true over time, governs who may see it, and refuses to bluff. Four arXiv papers describe how it works.
|
|
@@ -36,18 +32,43 @@ In Mode A, core remember and recall make no model-provider call: no API key, no
|
|
|
36
32
|
|
|
37
33
|
## Install
|
|
38
34
|
|
|
39
|
-
|
|
35
|
+
Three ways in. All three end in the same setup: your text memory on this machine, and, if you say yes, your pictures and documents too.
|
|
36
|
+
|
|
37
|
+
**1. Ask your agent.** Copy this into Claude Code, Codex, Cursor or any agent that can run commands:
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
Install SuperLocalMemory on this computer for me. Follow
|
|
41
|
+
https://github.com/qualixar/superlocalmemory/blob/main/SETUP_FOR_AGENTS.md
|
|
42
|
+
step by step and show me what each step printed. Ask me only one question,
|
|
43
|
+
before turning on anything optional: whether I also want to find my pictures,
|
|
44
|
+
screenshots and PDFs by describing them. Connect SuperLocalMemory to the agent
|
|
45
|
+
I am using. When you finish, run slm doctor and tell me in plain words what works.
|
|
46
|
+
```
|
|
40
47
|
|
|
48
|
+
**2. npm**, the primary route (Node 18+). It installs SLM into a package-owned virtual environment:
|
|
41
49
|
|
|
42
50
|
```bash
|
|
43
|
-
npm install -g superlocalmemory #
|
|
51
|
+
npm install -g superlocalmemory # add --media to also turn on pictures and documents
|
|
44
52
|
slm setup # pick Mode A to keep everything on this machine
|
|
45
|
-
slm connect
|
|
53
|
+
slm connect claude-code # or codex, cursor, windsurf, zed, claude-desktop, jetbrains, opencode ...
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
**3. pip**, the other primary route (Python 3.12 to 3.14), in a Python virtual environment you activate:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
python3 -m venv .venv
|
|
60
|
+
source .venv/bin/activate # Windows: .venv\Scripts\activate
|
|
61
|
+
python -m pip install superlocalmemory # or, without a venv: pipx install superlocalmemory
|
|
62
|
+
slm setup
|
|
63
|
+
slm connect claude-code
|
|
64
|
+
slm media enable # optional: pictures and documents (about 1.5 GB; needs 16 GB of memory)
|
|
46
65
|
```
|
|
47
66
|
|
|
48
|
-
**Claude Code:** `claude plugin marketplace add qualixar/superlocalmemory`, then `claude plugin install superlocalmemory@qualixar`.
|
|
67
|
+
**Claude Code plugin:** `claude plugin marketplace add qualixar/superlocalmemory`, then `claude plugin install superlocalmemory@qualixar`. **Codex:** `slm connect codex`, then `slm codex install`.
|
|
68
|
+
|
|
69
|
+
**Two models, one memory.** Text is searched with a small local text model (nomic). If you turn on pictures and documents, a second local model (Google's EmbeddingGemma 2) reads them, and one recall returns both. The picture model unloads after 30 minutes without use, so it holds no memory while you only work with text. Details: [pictures and documents](https://github.com/qualixar/superlocalmemory/blob/main/docs/pictures-and-documents.md), [getting started](https://github.com/qualixar/superlocalmemory/blob/main/docs/getting-started.md), [agent setup steps](https://github.com/qualixar/superlocalmemory/blob/main/SETUP_FOR_AGENTS.md).
|
|
49
70
|
|
|
50
|
-
|
|
71
|
+
Repository clone: `./scripts/install.sh install` (macOS, Linux) or `.\scripts\install.ps1 -Action Install` (Windows). Runs on Windows, Linux and Apple Silicon macOS ([platforms](#platform-support)).
|
|
51
72
|
|
|
52
73
|
## 30-second example
|
|
53
74
|
|
|
@@ -98,6 +119,16 @@ Real output from a fresh Mode A install, trimmed. Scores rank memories; they are
|
|
|
98
119
|
|
|
99
120
|
SuperLocalMemory is part of Qualixar's AI Reliability Engineering work: agent memory that is observable, bounded and honest about what it doesn't know.
|
|
100
121
|
|
|
122
|
+
## Watch it work
|
|
123
|
+
|
|
124
|
+
<div align="center">
|
|
125
|
+
|
|
126
|
+
[](https://www.youtube.com/watch?v=pyAu_vaIYZQ)
|
|
127
|
+
|
|
128
|
+
*The four-minute product film: Claude Code and Codex sharing one memory.*
|
|
129
|
+
|
|
130
|
+
</div>
|
|
131
|
+
|
|
101
132
|
## Works with your agents
|
|
102
133
|
|
|
103
134
|
**Every harness, every bot, one memory.** Any harness that speaks MCP (`slm mcp`, or `http://127.0.0.1:8765/mcp/`) or can run a command (`slm remember`, `slm recall`) can use SuperLocalMemory. The packaged plugins are ready-made examples, not a limit.
|
|
@@ -81,4 +81,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
|
|
|
81
81
|
# What NOT to do
|
|
82
82
|
Never session_init twice; never forget without dry-run preview; never run `slm gdpr erase --yes` unasked; never store secrets; never bypass role checks; never claim an erasure succeeded without verifying via recall.
|
|
83
83
|
|
|
84
|
-
SuperLocalMemory v4.2.
|
|
84
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -51,4 +51,4 @@ slm-recall · slm-remember · slm-session · slm-scope · slm-profile · slm-gov
|
|
|
51
51
|
# What NOT to do
|
|
52
52
|
Never session_init twice; never forget dry_run=False without reporting preview; never switch the active profile unasked; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit; never bypass scope or governance restrictions.
|
|
53
53
|
|
|
54
|
-
SuperLocalMemory v4.2.
|
|
54
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -41,4 +41,4 @@ slm-compress · slm-cache · slm-status · slm-profile
|
|
|
41
41
|
# What NOT to do
|
|
42
42
|
Never compress code-for-edit/JSON-to-parse/<500 chars; never store secrets/ccr_ids; never let optimize failure block/alter the task; never claim a specific savings %; never hand a ccr_id to another agent.
|
|
43
43
|
|
|
44
|
-
SuperLocalMemory v4.2.
|
|
44
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -245,7 +245,7 @@ Rules for reading them:
|
|
|
245
245
|
personal data. Folders connected with `slm sources` are never shown to web
|
|
246
246
|
apps. A web app cannot change, delete, pin or replace a memory it is not
|
|
247
247
|
allowed to see: it is answered as if that memory did not exist.
|
|
248
|
-
- Pictures saved before
|
|
248
|
+
- Pictures saved before picture search arrived are re-checked in the background and become
|
|
249
249
|
visible to web apps once their text is clean. They stay fully searchable on
|
|
250
250
|
this computer.
|
|
251
251
|
|
|
@@ -315,8 +315,14 @@ Settings) re-reads existing memories with the same on-device model that reads
|
|
|
315
315
|
pictures, so text and pictures share one search space. It runs in the
|
|
316
316
|
background, recall keeps working, the previous engine's data stays until the
|
|
317
317
|
owner frees it (`slm embedder forget-previous`), and `slm embedder rollback`
|
|
318
|
-
goes back.
|
|
319
|
-
|
|
318
|
+
goes back. If it cannot run, the command prints the reason.
|
|
319
|
+
|
|
320
|
+
It is not available for text yet: recall's answer check is not calibrated for
|
|
321
|
+
EmbeddingGemma 2 (the best fit so far answered questions that have no answer),
|
|
322
|
+
so the command refuses with that reason. Do not offer it, and never pass `--force` for the user.
|
|
323
|
+
If `slm doctor` reports "Answer check fit" as a warning, the user's text already
|
|
324
|
+
moved in an earlier version: tell them `slm embedder rollback` goes back in
|
|
325
|
+
minutes (previous vectors are kept) and let them decide.
|
|
320
326
|
|
|
321
327
|
---
|
|
322
328
|
|
|
@@ -331,4 +337,4 @@ command prints the reason. Offer it; do not run it unasked.
|
|
|
331
337
|
|
|
332
338
|
---
|
|
333
339
|
|
|
334
|
-
*SuperLocalMemory v4.2.
|
|
340
|
+
*SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
|
package/codex-plugin/AGENTS.md
CHANGED
|
@@ -187,4 +187,4 @@ Using this memory from a web assistant or another computer: see the slm-web-acce
|
|
|
187
187
|
- **slm-governance-advisor** — scope/role compliance, retention and lifecycle, GDPR
|
|
188
188
|
- **slm-loop-runner** — bounded, gate-verified loops (the `/slm-loop` command delegates to it)
|
|
189
189
|
|
|
190
|
-
SuperLocalMemory v4.2.
|
|
190
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
package/codex-plugin/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Local-first agent memory + reversible context compression for OpenAI Codex CLI.
|
|
4
4
|
|
|
5
|
-
SuperLocalMemory v4.2.
|
|
5
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -204,4 +204,4 @@ root (not inside a subdirectory), then restart Codex.
|
|
|
204
204
|
|
|
205
205
|
---
|
|
206
206
|
|
|
207
|
-
SuperLocalMemory v4.2.
|
|
207
|
+
SuperLocalMemory v4.2.2 · Qualixar · https://github.com/qualixar/superlocalmemory
|
|
@@ -81,4 +81,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
|
|
|
81
81
|
# What NOT to do
|
|
82
82
|
Never session_init twice; never forget without dry-run preview; never run `slm gdpr erase --yes` unasked; never store secrets; never bypass role checks; never claim an erasure succeeded without verifying via recall.
|
|
83
83
|
|
|
84
|
-
SuperLocalMemory v4.2.
|
|
84
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -51,4 +51,4 @@ slm-recall · slm-remember · slm-session · slm-scope · slm-profile · slm-gov
|
|
|
51
51
|
# What NOT to do
|
|
52
52
|
Never session_init twice; never forget dry_run=False without reporting preview; never switch the active profile unasked; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit; never bypass scope or governance restrictions.
|
|
53
53
|
|
|
54
|
-
SuperLocalMemory v4.2.
|
|
54
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -41,4 +41,4 @@ slm-compress · slm-cache · slm-status · slm-profile
|
|
|
41
41
|
# What NOT to do
|
|
42
42
|
Never compress code-for-edit/JSON-to-parse/<500 chars; never store secrets/ccr_ids; never let optimize failure block/alter the task; never claim a specific savings %; never hand a ccr_id to another agent.
|
|
43
43
|
|
|
44
|
-
SuperLocalMemory v4.2.
|
|
44
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -245,7 +245,7 @@ Rules for reading them:
|
|
|
245
245
|
personal data. Folders connected with `slm sources` are never shown to web
|
|
246
246
|
apps. A web app cannot change, delete, pin or replace a memory it is not
|
|
247
247
|
allowed to see: it is answered as if that memory did not exist.
|
|
248
|
-
- Pictures saved before
|
|
248
|
+
- Pictures saved before picture search arrived are re-checked in the background and become
|
|
249
249
|
visible to web apps once their text is clean. They stay fully searchable on
|
|
250
250
|
this computer.
|
|
251
251
|
|
|
@@ -315,8 +315,14 @@ Settings) re-reads existing memories with the same on-device model that reads
|
|
|
315
315
|
pictures, so text and pictures share one search space. It runs in the
|
|
316
316
|
background, recall keeps working, the previous engine's data stays until the
|
|
317
317
|
owner frees it (`slm embedder forget-previous`), and `slm embedder rollback`
|
|
318
|
-
goes back.
|
|
319
|
-
|
|
318
|
+
goes back. If it cannot run, the command prints the reason.
|
|
319
|
+
|
|
320
|
+
It is not available for text yet: recall's answer check is not calibrated for
|
|
321
|
+
EmbeddingGemma 2 (the best fit so far answered questions that have no answer),
|
|
322
|
+
so the command refuses with that reason. Do not offer it, and never pass `--force` for the user.
|
|
323
|
+
If `slm doctor` reports "Answer check fit" as a warning, the user's text already
|
|
324
|
+
moved in an earlier version: tell them `slm embedder rollback` goes back in
|
|
325
|
+
minutes (previous vectors are kept) and let them decide.
|
|
320
326
|
|
|
321
327
|
---
|
|
322
328
|
|
|
@@ -331,4 +337,4 @@ command prints the reason. Offer it; do not run it unasked.
|
|
|
331
337
|
|
|
332
338
|
---
|
|
333
339
|
|
|
334
|
-
*SuperLocalMemory v4.2.
|
|
340
|
+
*SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later*
|
|
@@ -9,7 +9,7 @@ description: >
|
|
|
9
9
|
tools: recall, search, remember, update_memory, list_recent, Read, Bash
|
|
10
10
|
model: inherit
|
|
11
11
|
target: vscode
|
|
12
|
-
version: "4.2.
|
|
12
|
+
version: "4.2.2"
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
# Role
|
|
@@ -83,4 +83,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
|
|
|
83
83
|
# What NOT to do
|
|
84
84
|
Never session_init twice; never forget without dry-run preview; never run `slm gdpr erase --yes` unasked; never store secrets; never bypass role checks; never claim an erasure succeeded without verifying via recall.
|
|
85
85
|
|
|
86
|
-
SuperLocalMemory v4.2.
|
|
86
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|
|
@@ -11,7 +11,7 @@ description: >
|
|
|
11
11
|
tools: Bash, recall, remember, Read, slm_loop_run, slm_loop_history, slm_loop_show
|
|
12
12
|
model: inherit
|
|
13
13
|
target: vscode
|
|
14
|
-
version: "4.2.
|
|
14
|
+
version: "4.2.2"
|
|
15
15
|
---
|
|
16
16
|
|
|
17
17
|
# Role
|
|
@@ -81,4 +81,4 @@ assessment. The gate is the authority.
|
|
|
81
81
|
|
|
82
82
|
---
|
|
83
83
|
|
|
84
|
-
SuperLocalMemory v4.2.
|
|
84
|
+
SuperLocalMemory v4.2.2 · Qualixar · AGPL-3.0-or-later
|