PyPI - superlocalmemory - Versions diffs - 4.2.4__tar.gz → 4.2.6__tar.gz - Mend

superlocalmemory 4.2.4tar.gz → 4.2.6tar.gz

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 (1534) hide show

{superlocalmemory-4.2.4/src/superlocalmemory.egg-info → superlocalmemory-4.2.6}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 4.2.4
+Version: 4.2.6
 Summary: The governed memory brain for AI agents: one local memory for Claude Code, Codex, Cursor, Copilot, ChatGPT and any MCP client
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License-Expression: AGPL-3.0-or-later
@@ -114,6 +114,7 @@ Requires-Dist: httpx2==2.12.0; extra == "dev"
 Requires-Dist: import-linter==2.15; extra == "dev"
 Dynamic: license-file
+<!-- mcp-name: io.github.qualixar/superlocalmemory -->
 <div align="center">
 <picture>
@@ -135,7 +136,7 @@ Dynamic: license-file
 [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue)](https://github.com/qualixar/superlocalmemory/blob/main/LICENSE)
 [![Research: 4 arXiv papers](https://img.shields.io/badge/arXiv-4_papers-b31b1b)](#research)
-**[Install](#install)** · **[See it work](#30-second-example)** · **[Product film](https://www.youtube.com/watch?v=pyAu_vaIYZQ)** · **[Every capability](#everything-slm-does)** · **[Docs](#documentation)** · **[Website](https://www.superlocalmemory.com)**
+**[Install](#install)** · **[See it work](#30-second-example)** · **[Full demo](https://www.youtube.com/watch?v=9Y0wAT07KTc)** · **[Every capability](#everything-slm-does)** · **[Docs](#documentation)** · **[Website](https://www.superlocalmemory.com)**
 <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">
@@ -247,12 +248,40 @@ SuperLocalMemory is part of Qualixar's AI Reliability Engineering work: agent me
 <div align="center">
-[![Watch the SuperLocalMemory product film: Claude Code and Codex sharing one memory](https://img.youtube.com/vi/pyAu_vaIYZQ/maxresdefault.jpg)](https://www.youtube.com/watch?v=pyAu_vaIYZQ)
+[![Watch the full SuperLocalMemory demo: AI agent memory shared by Claude Code, Codex, ChatGPT and Grok Bot](https://img.youtube.com/vi/9Y0wAT07KTc/maxresdefault.jpg)](https://www.youtube.com/watch?v=9Y0wAT07KTc)
-*The four-minute product film: Claude Code and Codex sharing one memory.*
+*The full eight-minute demo: one memory shared by your coding agents and bots, every tab.*
 </div>
+## Add SuperLocalMemory to your app
+You do not need to wait for an app store. Every app below can take SuperLocalMemory straight from this GitHub repository, `qualixar/superlocalmemory`, in two steps.
+**Step 1, once per computer.** Install SuperLocalMemory: `npm install -g superlocalmemory` (or `pipx install superlocalmemory`). Your memory lives on this computer from then on.
+**Step 2, in each app you use:**
+| Your app | What to do |
+|---|---|
+| **Claude Code** (terminal and desktop app) | Type `/plugin marketplace add qualixar/superlocalmemory`, then `/plugin install superlocalmemory@qualixar` |
+| **Claude Desktop** | Run `slm connect claude-desktop`, then restart Claude Desktop |
+| **ChatGPT, Claude on the web, Muse, Composio** | Open the dashboard (`slm dashboard`) → **Web access** → turn it on, then add the link it shows as a connector in that app ([step-by-step](https://github.com/qualixar/superlocalmemory/blob/main/docs/remote-access/hosts.md)) |
+| **Codex** (terminal and desktop app) | Run `codex plugin marketplace add qualixar/superlocalmemory --ref main`, then `codex plugin add superlocalmemory-codex@qualixar` |
+| **Cursor** (editor and Agents window) | Run `slm connect cursor`, then restart Cursor |
+| **VS Code** (Copilot chat in the editor) | Install the SuperLocalMemory extension (`.vsix` from the [latest release](https://github.com/qualixar/superlocalmemory/releases/latest): Extensions → `...` → Install from VSIX) |
+| **VS Code Agents window, GitHub Copilot CLI** | Run `slm connect copilot-cli`; for the skills, add `qualixar/superlocalmemory` in the Agents window's Plugins screen |
+| **Antigravity** | Run `agy plugin install "$(npm root -g)/superlocalmemory/antigravity-plugin"` |
+| **Grok CLI** | Run `grok plugin install 'qualixar/superlocalmemory#plugin'` |
+| **Grok Bot** | In Grok's Plugins screen, add the marketplace `qualixar/superlocalmemory` and add `superlocalmemory` |
+| **Muse CLI** | Run `slm connect muse`, then `muse plugins install "$(npm root -g)/superlocalmemory/muse-plugin"` and `muse plugins approve superlocalmemory` |
+| **Hermes** (terminal and desktop app) | Run `hermes plugins install 'https://github.com/qualixar/superlocalmemory.git#hermes-plugin'`, then `slm upgrade-hosts --host hermes --apply` |
+| **OpenClaw** | Run `slm connect openclaw` |
+| **Windsurf, Zed, JetBrains, Gemini CLI, OpenCode, Continue** | Run `slm connect <app>`, for example `slm connect windsurf` |
+| **Anything else that speaks MCP** | Add a server with the command `slm` and the argument `mcp` |
+Restart the app after adding SuperLocalMemory. Then ask it something like *"What do you remember about this project?"* The [plugin guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md) has the details for each app, and `slm doctor` checks your setup.
 ## Works with your agents
 **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.
@@ -263,7 +292,12 @@ SuperLocalMemory is part of Qualixar's AI Reliability Engineering work: agent me
 | **Codex** | `slm connect codex`, then `slm codex install` | MCP, 16 skills, 4 agents, `/slm-loop`, lifecycle hooks |
 | **GitHub Copilot** (VS Code, Visual Studio, JetBrains, CLI) | `slm connect vscode-copilot --here` | MCP, agent rules, 16 prompts, 4 agents, hooks |
 | **Antigravity** | `agy plugin install` the bundled plugin | MCP, 16 skills, 4 agents, `/slm-loop`, hooks |
-| **Hermes** | Native plugin | 16 skills, advisor agents, `/slm <command>` |
+| **Hermes** | Native plugin, then `slm upgrade-hosts --host hermes --apply` to grant it the memory server | 16 skills, advisor agents, `/slm <command>`, recall and session hooks |
+| **VS Code** | The SuperLocalMemory extension (`.vsix` on the [release page](https://github.com/qualixar/superlocalmemory/releases/latest)) | The memory server in the agent's tool list, nothing to edit |
+| **Grok CLI** | `slm connect grok-cli`, then `grok plugin install` the bundled plugin | MCP, 16 skills, 4 agents, session and recall hooks |
+| **VS Code Agents window, GitHub Copilot CLI** | `slm connect copilot-cli`; skills and agents from the Plugins screen | MCP, 16 skills, 4 agents |
+| **OpenClaw** | `slm connect openclaw` | MCP and 14 skills |
+| **Muse CLI** | `slm connect muse`, then `muse plugins install` the bundled plugin | MCP, 16 skills, 4 agents, `/slm-loop`, session and recall hooks |
 | **Grok Bot and Cursor-format hosts** | Add the `qualixar` plugin marketplace | A lean plugin built for shared bot computers ([guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md#grok-bot-and-other-cursor-format-hosts)) |
 | **Cursor, Windsurf, Zed, JetBrains, Gemini CLI, Claude Desktop, OpenCode, Continue** | `slm connect <name>` | MCP in that tool's own config |
 | **ChatGPT, Claude on the web, Muse, Composio** | Optional **Web access** from the dashboard: sign in per app, read-only or read-and-save, remove any app at once | Your local memory, from the web; the database never leaves your computer ([guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/remote-access/README.md)) |
@@ -386,14 +420,21 @@ Engineering controls that support a compliance program, not a certification.
 ## MCP memory server: tool profiles
-Pick how many tools your agent sees with `SLM_MCP_PROFILE`.
+Every app, plugin and extension gets `full` (58 tools: all of memory, SLM-Mesh, optimize, loops) unless you choose otherwise. That fits hosts that cap the total number of MCP tools at about 100, with room for your other servers. To change it for every app at once, run one command and restart your apps:
+```bash
+slm tools                # current set, and how many tools each set has
+slm tools set power      # any name below; `slm tools set default` goes back to full
+```
+To change one app only, set `SLM_MCP_PROFILE` in that app's MCP config (`slm connect <app> --profile <name>` writes it); it wins over the saved choice for that app. [Per-app details](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md#choosing-how-many-tools)
 | Profile | Tools | For |
 |---|---:|---|
 | `core` | 19 | Remember, recall, expand, sessions, optimize, correction review |
 | `code` | 39 | Core plus code graph, memory kinds, Brain evidence, profile switching, bounded loops |
 | `mesh` | 9 | SLM-Mesh coordination only |
-| `full` (and unset) | 58 | Memory, kinds, Brain, optimize, skill evolution, mesh, loops, views and summaries (63 with pictures and documents on) |
+| `full` (default, when unset) | 58 | Memory, kinds, Brain, optimize, skill evolution, mesh, loops, views and summaries (63 with pictures and documents on) |
 | `power` | 70 | Full plus administration, lifecycle and diagnostics (75 with pictures and documents on) |
 | `whole` | 110 | Every registered tool |
@@ -407,7 +448,7 @@ stdio: `{"command": "slm", "args": ["mcp"]}` · HTTP: `http://127.0.0.1:8765/mcp
 | **Entity Explorer** | **The answer check at work** |
 | <img src="https://raw.githubusercontent.com/qualixar/superlocalmemory/main/docs/assets/gifs/entities.gif" alt="Entity Explorer: projects and tools with their facts and timeline"> | <img src="https://raw.githubusercontent.com/qualixar/superlocalmemory/main/docs/screenshots/dashboard/answer-check-answered.png" alt="Answer Check: the on-device model judges that the memories answer the question, with its confidence and timing"> |
-Recorded on a test install with fictional memories. [The four-minute product film](https://www.youtube.com/watch?v=pyAu_vaIYZQ) walks through every pane.
+Recorded on a test install with fictional memories. [The eight-minute full demo](https://www.youtube.com/watch?v=9Y0wAT07KTc) walks through every pane.
 ## Architecture

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/README.md RENAMED Viewed

@@ -1,3 +1,4 @@
+<!-- mcp-name: io.github.qualixar/superlocalmemory -->
 <div align="center">
 <picture>
@@ -19,7 +20,7 @@
 [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue)](https://github.com/qualixar/superlocalmemory/blob/main/LICENSE)
 [![Research: 4 arXiv papers](https://img.shields.io/badge/arXiv-4_papers-b31b1b)](#research)
-**[Install](#install)** · **[See it work](#30-second-example)** · **[Product film](https://www.youtube.com/watch?v=pyAu_vaIYZQ)** · **[Every capability](#everything-slm-does)** · **[Docs](#documentation)** · **[Website](https://www.superlocalmemory.com)**
+**[Install](#install)** · **[See it work](#30-second-example)** · **[Full demo](https://www.youtube.com/watch?v=9Y0wAT07KTc)** · **[Every capability](#everything-slm-does)** · **[Docs](#documentation)** · **[Website](https://www.superlocalmemory.com)**
 <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">
@@ -131,12 +132,40 @@ SuperLocalMemory is part of Qualixar's AI Reliability Engineering work: agent me
 <div align="center">
-[![Watch the SuperLocalMemory product film: Claude Code and Codex sharing one memory](https://img.youtube.com/vi/pyAu_vaIYZQ/maxresdefault.jpg)](https://www.youtube.com/watch?v=pyAu_vaIYZQ)
+[![Watch the full SuperLocalMemory demo: AI agent memory shared by Claude Code, Codex, ChatGPT and Grok Bot](https://img.youtube.com/vi/9Y0wAT07KTc/maxresdefault.jpg)](https://www.youtube.com/watch?v=9Y0wAT07KTc)
-*The four-minute product film: Claude Code and Codex sharing one memory.*
+*The full eight-minute demo: one memory shared by your coding agents and bots, every tab.*
 </div>
+## Add SuperLocalMemory to your app
+You do not need to wait for an app store. Every app below can take SuperLocalMemory straight from this GitHub repository, `qualixar/superlocalmemory`, in two steps.
+**Step 1, once per computer.** Install SuperLocalMemory: `npm install -g superlocalmemory` (or `pipx install superlocalmemory`). Your memory lives on this computer from then on.
+**Step 2, in each app you use:**
+| Your app | What to do |
+|---|---|
+| **Claude Code** (terminal and desktop app) | Type `/plugin marketplace add qualixar/superlocalmemory`, then `/plugin install superlocalmemory@qualixar` |
+| **Claude Desktop** | Run `slm connect claude-desktop`, then restart Claude Desktop |
+| **ChatGPT, Claude on the web, Muse, Composio** | Open the dashboard (`slm dashboard`) → **Web access** → turn it on, then add the link it shows as a connector in that app ([step-by-step](https://github.com/qualixar/superlocalmemory/blob/main/docs/remote-access/hosts.md)) |
+| **Codex** (terminal and desktop app) | Run `codex plugin marketplace add qualixar/superlocalmemory --ref main`, then `codex plugin add superlocalmemory-codex@qualixar` |
+| **Cursor** (editor and Agents window) | Run `slm connect cursor`, then restart Cursor |
+| **VS Code** (Copilot chat in the editor) | Install the SuperLocalMemory extension (`.vsix` from the [latest release](https://github.com/qualixar/superlocalmemory/releases/latest): Extensions → `...` → Install from VSIX) |
+| **VS Code Agents window, GitHub Copilot CLI** | Run `slm connect copilot-cli`; for the skills, add `qualixar/superlocalmemory` in the Agents window's Plugins screen |
+| **Antigravity** | Run `agy plugin install "$(npm root -g)/superlocalmemory/antigravity-plugin"` |
+| **Grok CLI** | Run `grok plugin install 'qualixar/superlocalmemory#plugin'` |
+| **Grok Bot** | In Grok's Plugins screen, add the marketplace `qualixar/superlocalmemory` and add `superlocalmemory` |
+| **Muse CLI** | Run `slm connect muse`, then `muse plugins install "$(npm root -g)/superlocalmemory/muse-plugin"` and `muse plugins approve superlocalmemory` |
+| **Hermes** (terminal and desktop app) | Run `hermes plugins install 'https://github.com/qualixar/superlocalmemory.git#hermes-plugin'`, then `slm upgrade-hosts --host hermes --apply` |
+| **OpenClaw** | Run `slm connect openclaw` |
+| **Windsurf, Zed, JetBrains, Gemini CLI, OpenCode, Continue** | Run `slm connect <app>`, for example `slm connect windsurf` |
+| **Anything else that speaks MCP** | Add a server with the command `slm` and the argument `mcp` |
+Restart the app after adding SuperLocalMemory. Then ask it something like *"What do you remember about this project?"* The [plugin guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md) has the details for each app, and `slm doctor` checks your setup.
 ## Works with your agents
 **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.
@@ -147,7 +176,12 @@ SuperLocalMemory is part of Qualixar's AI Reliability Engineering work: agent me
 | **Codex** | `slm connect codex`, then `slm codex install` | MCP, 16 skills, 4 agents, `/slm-loop`, lifecycle hooks |
 | **GitHub Copilot** (VS Code, Visual Studio, JetBrains, CLI) | `slm connect vscode-copilot --here` | MCP, agent rules, 16 prompts, 4 agents, hooks |
 | **Antigravity** | `agy plugin install` the bundled plugin | MCP, 16 skills, 4 agents, `/slm-loop`, hooks |
-| **Hermes** | Native plugin | 16 skills, advisor agents, `/slm <command>` |
+| **Hermes** | Native plugin, then `slm upgrade-hosts --host hermes --apply` to grant it the memory server | 16 skills, advisor agents, `/slm <command>`, recall and session hooks |
+| **VS Code** | The SuperLocalMemory extension (`.vsix` on the [release page](https://github.com/qualixar/superlocalmemory/releases/latest)) | The memory server in the agent's tool list, nothing to edit |
+| **Grok CLI** | `slm connect grok-cli`, then `grok plugin install` the bundled plugin | MCP, 16 skills, 4 agents, session and recall hooks |
+| **VS Code Agents window, GitHub Copilot CLI** | `slm connect copilot-cli`; skills and agents from the Plugins screen | MCP, 16 skills, 4 agents |
+| **OpenClaw** | `slm connect openclaw` | MCP and 14 skills |
+| **Muse CLI** | `slm connect muse`, then `muse plugins install` the bundled plugin | MCP, 16 skills, 4 agents, `/slm-loop`, session and recall hooks |
 | **Grok Bot and Cursor-format hosts** | Add the `qualixar` plugin marketplace | A lean plugin built for shared bot computers ([guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md#grok-bot-and-other-cursor-format-hosts)) |
 | **Cursor, Windsurf, Zed, JetBrains, Gemini CLI, Claude Desktop, OpenCode, Continue** | `slm connect <name>` | MCP in that tool's own config |
 | **ChatGPT, Claude on the web, Muse, Composio** | Optional **Web access** from the dashboard: sign in per app, read-only or read-and-save, remove any app at once | Your local memory, from the web; the database never leaves your computer ([guide](https://github.com/qualixar/superlocalmemory/blob/main/docs/remote-access/README.md)) |
@@ -270,14 +304,21 @@ Engineering controls that support a compliance program, not a certification.
 ## MCP memory server: tool profiles
-Pick how many tools your agent sees with `SLM_MCP_PROFILE`.
+Every app, plugin and extension gets `full` (58 tools: all of memory, SLM-Mesh, optimize, loops) unless you choose otherwise. That fits hosts that cap the total number of MCP tools at about 100, with room for your other servers. To change it for every app at once, run one command and restart your apps:
+```bash
+slm tools                # current set, and how many tools each set has
+slm tools set power      # any name below; `slm tools set default` goes back to full
+```
+To change one app only, set `SLM_MCP_PROFILE` in that app's MCP config (`slm connect <app> --profile <name>` writes it); it wins over the saved choice for that app. [Per-app details](https://github.com/qualixar/superlocalmemory/blob/main/docs/plugins.md#choosing-how-many-tools)
 | Profile | Tools | For |
 |---|---:|---|
 | `core` | 19 | Remember, recall, expand, sessions, optimize, correction review |
 | `code` | 39 | Core plus code graph, memory kinds, Brain evidence, profile switching, bounded loops |
 | `mesh` | 9 | SLM-Mesh coordination only |
-| `full` (and unset) | 58 | Memory, kinds, Brain, optimize, skill evolution, mesh, loops, views and summaries (63 with pictures and documents on) |
+| `full` (default, when unset) | 58 | Memory, kinds, Brain, optimize, skill evolution, mesh, loops, views and summaries (63 with pictures and documents on) |
 | `power` | 70 | Full plus administration, lifecycle and diagnostics (75 with pictures and documents on) |
 | `whole` | 110 | Every registered tool |
@@ -291,7 +332,7 @@ stdio: `{"command": "slm", "args": ["mcp"]}` · HTTP: `http://127.0.0.1:8765/mcp
 | **Entity Explorer** | **The answer check at work** |
 | <img src="https://raw.githubusercontent.com/qualixar/superlocalmemory/main/docs/assets/gifs/entities.gif" alt="Entity Explorer: projects and tools with their facts and timeline"> | <img src="https://raw.githubusercontent.com/qualixar/superlocalmemory/main/docs/screenshots/dashboard/answer-check-answered.png" alt="Answer Check: the on-device model judges that the memories answer the question, with its confidence and timing"> |
-Recorded on a test install with fictional memories. [The four-minute product film](https://www.youtube.com/watch?v=pyAu_vaIYZQ) walks through every pane.
+Recorded on a test install with fictional memories. [The eight-minute full demo](https://www.youtube.com/watch?v=9Y0wAT07KTc) walks through every pane.
 ## Architecture

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/agents/slm-governance-advisor.md RENAMED Viewed

@@ -81,4 +81,4 @@ slm-scope · slm-governance · slm-profile · slm-remember · slm-recall · slm-
 # What NOT to do
 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.
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/agents/slm-loop-runner.md RENAMED Viewed

@@ -79,4 +79,4 @@ assessment. The gate is the authority.
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/agents/slm-memory-advisor.md RENAMED Viewed

@@ -51,4 +51,4 @@ slm-recall · slm-remember · slm-session · slm-scope · slm-profile · slm-gov
 # What NOT to do
 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.
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/agents/slm-optimize-advisor.md RENAMED Viewed

@@ -41,4 +41,4 @@ slm-compress · slm-cache · slm-status · slm-profile
 # What NOT to do
 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.
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/rules/AGENTS.md RENAMED Viewed

@@ -187,4 +187,4 @@ Using this memory from a web assistant or another computer: see the slm-web-acce
 - **slm-governance-advisor** — scope/role compliance, retention and lifecycle, GDPR
 - **slm-loop-runner** — bounded, gate-verified loops (the `/slm-loop` command delegates to it)
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/rules/CLAUDE.md.fragment RENAMED Viewed

@@ -1,4 +1,4 @@
-<!-- BEGIN SuperLocalMemory v4.2.4 -->
+<!-- BEGIN SuperLocalMemory v4.2.6 -->
 ## SuperLocalMemory (SLM) — Agent Rules
@@ -51,6 +51,6 @@ slm-recall · slm-remember · slm-session · slm-status · slm-cache · slm-comp
 ### Subagents
 slm-memory-advisor (memory decisions, session hygiene, scope/profile guidance) · slm-optimize-advisor (context compression + KV cache) · slm-governance-advisor (scope/roles/compliance/GDPR) · slm-loop-runner (bounded, gate-verified loops)
-<!-- END SuperLocalMemory v4.2.4 -->
+<!-- END SuperLocalMemory v4.2.6 -->
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-bot-memory/SKILL.md RENAMED Viewed

@@ -178,4 +178,4 @@ store every local bot on that computer can reach.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-cache/SKILL.md RENAMED Viewed

@@ -144,4 +144,4 @@ These subcommands control daemon-level cache settings and bulk removal. They do
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-compress/SKILL.md RENAMED Viewed

@@ -147,4 +147,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-getting-started-bot/SKILL.md RENAMED Viewed

@@ -194,4 +194,4 @@ quality on a shared box.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-governance/SKILL.md RENAMED Viewed

@@ -20,7 +20,9 @@ SuperLocalMemory can run with named users and roles per workspace (company
 mode), keeps a compliance audit trail, applies a retention lifecycle, and ships
 GDPR export and erasure commands. This skill documents how an agent must behave
 in a governed workspace and what the governance tools really do. The MCP audit
-and retention tools are in the `power` tool set (see `slm-profile`).
+and retention tools are in the `power` tool set, not the default: if they are
+missing, tell the user to run `slm tools set power` and restart this app (see
+`slm-profile`). The `slm gdpr` and `slm team` commands work either way.
 ---
@@ -274,4 +276,4 @@ Before running any destructive or state-changing operation (`forget`,
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-graph/SKILL.md RENAMED Viewed

@@ -20,7 +20,7 @@ allowed-tools: build_code_graph, query_graph, get_blast_radius, semantic_search_
 # slm-graph — Code Intelligence Skill
-Index any repo as a code knowledge graph and answer structural questions about it: callers, callees, impact radius, semantic search, and review context. These tools are only registered in the `code` MCP tool set (or with `SLM_MCP_ALL_TOOLS=1`); see "Tool set requirement" below.
+Index any repo as a code knowledge graph and answer structural questions about it: callers, callees, impact radius, semantic search, and review context. These tools are not in the default tool set: they need `slm tools set code` (or `whole`); see "Tool set requirement" below.
 **Prerequisite rule:** every tool except `build_code_graph` self-guards — if the graph is not built it returns `{"success": false, "error": "Code graph not built. Run build_code_graph first."}`. Always index first.
@@ -289,17 +289,11 @@ If `build_code_graph` returns `files_parsed: 0`, no supported source files were
 The six tools above are registered only when the MCP server runs the `code` tool
 set, or with `SLM_MCP_ALL_TOOLS=1` / `SLM_MCP_PROFILE=whole`, or when
 `SLM_MCP_TOOLS` names them. They are **not** in `core`, `full`, `power` or the
-no-profile default that the Claude Code and Codex plugins use, so with those
-settings the tools simply do not exist and a call fails as an unknown tool. The
-tool set is read when the server starts: set it in the host's MCP config and
-restart the host.
-```json
-"env": {
-  "SLM_MCP_PROFILE": "code",
-  "SLM_AGENT_ID": "claude_code"
-}
-```
+default every app gets, so there the tools do not exist and a call fails as an
+unknown tool. If the user asks for graph work and the tools are missing, tell
+them: "Code-graph tools are off by default. Run `slm tools set code` (graph
+without mesh) or `slm tools set whole` (every tool), then restart this app."
+Let them choose; it changes the tools every connected app sees.
 `switch_profile` does not change the tool set; it changes the active memory
 profile. See `slm-profile`. The `code` set leaves out the mesh and several
@@ -324,4 +318,4 @@ All are host-only: a remote caller cannot use them.
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-loop/SKILL.md RENAMED Viewed

@@ -171,4 +171,4 @@ Guides: `docs/skill-evolution.md`, `docs/bounded-loops-bridge.md`.
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-media/SKILL.md RENAMED Viewed

@@ -337,4 +337,4 @@ minutes (previous vectors are kept) and let them decide.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-mesh/SKILL.md RENAMED Viewed

@@ -386,4 +386,4 @@ mesh availability.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-profile/SKILL.md RENAMED Viewed

@@ -1,6 +1,6 @@
 ---
 name: slm-profile
-description: Memory profiles (separate namespaces inside one SuperLocalMemory store) and MCP tool sets (which tools your host sees). Use switch_profile or slm profile switch to change the active memory profile, the profile_id argument to read or write another profile for one call, and SLM_MCP_PROFILE to choose a tool set. Required when working across multiple projects, clients, or tenants.
+description: Memory profiles (separate namespaces inside one SuperLocalMemory store) and MCP tool sets (which tools your host sees). Use switch_profile or slm profile switch to change the active memory profile, the profile_id argument to read or write another profile for one call, and `slm tools set <name>` to choose the tool set every connected app sees. Required when working across multiple projects, clients, or tenants.
 when_to_use: |
   - "Switch to my work profile"
   - "What profile am I currently in?"
@@ -97,14 +97,15 @@ named differently (for example `superlocalmemory-personal` and
 | Profile | Tools | What it is |
 |---------|-------|------------|
-| `core` | 19 tools — remember, recall, search, fetch, expand, list_recent, update_memory, forget, session, optimize, corrections, summaries, switch_profile | Smallest set; the Grok Bot / Cursor plugin uses it |
+| `core` | 19 tools — remember, recall, search, fetch, expand, list_recent, update_memory, forget, session, optimize, corrections, summaries, switch_profile | Smallest set |
 | `code` | 39 tools — core + portable Brain evidence, report_outcome/report_feedback, 6 code-graph tools, memory kinds, bounded loops | For coding agents that need the graph; no mesh, no `get_status` |
-| `full` | 58 tools — everyday memory, delete_memory, get_status, observe, saved views, learning tools, skills, optimize, kinds, loops, mesh | Same set as the no-profile default |
+| `full` | 58 tools — everyday memory, delete_memory, get_status, observe, saved views, learning tools, skills, optimize, kinds, loops, mesh | The default for every app |
 | `power` | 70 tools — full + audit_trail, retention, compaction, consistency_check, behavioral and diagnostic tools | Governance and admin work |
 | `mesh` | 9 tools — mesh coordination only | Lightweight cross-session signalling |
-A host that sets no profile gets the 58-tool `full` set (this is what the Claude
-Code and Codex plugins do; the Antigravity plugin sets `power`). While pictures
+Every app gets the 58-tool `full` set unless the user chose another: no plugin
+or extension SuperLocalMemory ships sets one. It fits hosts that cap the total
+number of MCP tools at about 100. While pictures
 and documents are on (`slm media status`), `full` lists 62 tools and `power` 74:
 the five picture tools `remember_media`, `get_media`, `remember_document`,
 `media_status` and `media_upload_link` are added to both, and never to `core`,
@@ -117,19 +118,19 @@ such as `core_memory` and `settle_session_outcomes` exist only with
 `SLM_MCP_ALL_TOOLS=1`, `whole` or an explicit `SLM_MCP_TOOLS` list. Tools whose
 function is to manage the SLM computer are never available to a remote caller.
-The tool set is read when the MCP server starts. To change it, set it in the
-host's MCP config and restart the host; asking the server at runtime does not
-work:
+The tool set is read when the MCP server starts. To change it for every app at
+once, the user runs one command and then restarts their apps (or reconnects
+them in Dashboard → Connected apps); asking the server at runtime does not work:
-```json
-"env": {
-  "SLM_MCP_PROFILE": "code",
-  "SLM_AGENT_ID": "claude_code"
-}
+```bash
+slm tools                 # the current set and how many tools each set has
+slm tools set power       # core, code, full, power, mesh or whole
+slm tools set default     # back to full
 ```
-`slm connect <ide> --profile <name>` writes that variable into a supported
-host's config. Setting `SLM_MCP_PROFILE` to a name that does not exist stops
+An app whose own MCP config sets `SLM_MCP_PROFILE` keeps that value: it wins
+over the saved choice, for that app only (`slm connect <ide> --profile <name>`
+writes it). Setting `SLM_MCP_PROFILE` to a name that does not exist stops
 `slm mcp` with a message listing the valid names. Older count-suffixed names
 such as `code20`, `full38` and `power50` still resolve, with a startup warning.
 On an install that already has memories, do not set `SLM_DATA_DIR` in the MCP
@@ -142,8 +143,10 @@ set. It is not in `mesh`.
 ## If a tool is missing
-Check the tool set first (`slm status` does not show it; look at the host's MCP
-config for `SLM_MCP_PROFILE`). Mesh tools need `full`, `power`, `mesh` or the
+Check the tool set first: `slm tools` shows it (an app's own `SLM_MCP_PROFILE`,
+if set, overrides it for that app). Tell the user which set has the tool and
+the command, for example "run `slm tools set power` and restart this app", and
+let them decide; widening the set adds tools to every connected app. Mesh tools need `full`, `power`, `mesh` or the
 default. Picture and PDF tools need `full`, `power` or `whole` and the feature
 turned on (`slm media enable`). Code-graph tools need `code` or `SLM_MCP_ALL_TOOLS=1`. Audit and
 retention tools need `power`. `report_outcome` and `report_feedback` need
@@ -161,4 +164,4 @@ anything but `core` or `mesh`.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-recall/SKILL.md RENAMED Viewed

@@ -515,4 +515,4 @@ See `slm-profile`.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-remember/SKILL.md RENAMED Viewed

@@ -372,4 +372,4 @@ sessions on this machine, so use it only when the user asks to move. See
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-scope/SKILL.md RENAMED Viewed

@@ -180,4 +180,4 @@ to review the impact. See `slm-remember` for the full deletion discipline.
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-session/SKILL.md RENAMED Viewed

@@ -288,4 +288,4 @@ answered. To also surface shared or global facts, call `recall` with
 ---
-*SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/plugin-src/skills/slm-status/SKILL.md RENAMED Viewed

@@ -228,4 +228,4 @@ the memory-engine upgrade is pending.
 ---
-SuperLocalMemory v4.2.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "4.2.4"
+version = "4.2.6"
 description = "The governed memory brain for AI agents: one local memory for Claude Code, Codex, Cursor, Copilot, ChatGPT and any MCP client"
 readme = "README.md"
 license = "AGPL-3.0-or-later"
@@ -289,6 +289,9 @@ dev = [
     "httpx2==2.12.0",
     "pytest>=9.0.2",
     "pytest-asyncio>=0.21",
+    # The release gate runs the ~22k-test suite in parallel (-n); serial it needs
+    # more than the job's whole time budget. Dev group only, never published.
+    "pytest-xdist>=3.6",
     "twine>=6.2.0",
     "wheel==0.46.3",
 ]

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/src/superlocalmemory/__init__.py RENAMED Viewed

@@ -32,7 +32,7 @@ if "OMP_NUM_THREADS" not in os.environ:
     os.environ["OMP_NUM_THREADS"] = "2"
 # ---------------------------------------------------------------------------
-__version__ = "4.2.4"
+__version__ = "4.2.6"
 _REQUIRED_VERSIONS = {
     "sentence_transformers": "5.6.1",

{superlocalmemory-4.2.4 → superlocalmemory-4.2.6}/src/superlocalmemory/cli/commands.py RENAMED Viewed

@@ -672,6 +672,7 @@ def dispatch(args: Namespace) -> None:
         "doctor": cmd_doctor,
         "trace": cmd_trace,
         "mcp": cmd_mcp,
+        "tools": _cmd_tools,
         "warmup": cmd_warmup,
         "dashboard": cmd_dashboard,
         "profile": cmd_profile,
@@ -2989,6 +2990,7 @@ _COMMAND_GROUPS: list[tuple[str, list[tuple[str, str]]]] = [
         ("restart", "Restart the daemon (applies restart-only settings)"),
         ("dashboard", "Open the web dashboard on the configured daemon port"),
         ("mcp", "Start the MCP server (used by IDEs)"),
+        ("tools", "Show or choose how many MCP tools your apps see"),
         ("remote", "Let other computers use this SLM over HTTPS with revocable keys"),
         ("warmup", "Pre-load models so the first recall is fast"),
         ("status", "Show daemon status + memory counts"),
@@ -4042,6 +4044,7 @@ def _cmd_doctor_checks(args: Namespace, state: dict) -> None:
             "hidden_by_forgetting": _h.hidden_by_forgetting,
             "inconsistently_hidden": _h.inconsistently_hidden,
             "missing_projection": _h.missing_projection,
+            "indexing": _h.indexing,
             "index_verified": _h.index_verified,
             "reachability": round(_h.reachability, 4),
             "healthy": _h.healthy,
@@ -4069,6 +4072,14 @@ def _cmd_doctor_checks(args: Namespace, state: dict) -> None:
     from superlocalmemory.cli.doctor_mcp import connected_apps_finding
     _check("Connected MCP apps", *connected_apps_finding())
+    try:  # 4.2.6: a Hermes without the grant runs the SLM plugin inert
+        from superlocalmemory.cli.host_upgrades import hermes_plugin_finding
+        _hermes = hermes_plugin_finding()
+        if _hermes is not None:
+            _check("Hermes plugin access", _hermes[0], _hermes[1], fix=_hermes[2])
+    except Exception as _hp_exc:  # noqa: BLE001 — a report must not break doctor
+        _check("Hermes plugin access", "WARN", f"could not be checked: {_hp_exc}")
     refile_data = None
     if getattr(args, "refile_hidden", False):
         from superlocalmemory.cli.doctor_refile import run_refile
@@ -4238,6 +4249,11 @@ def cmd_trace(args: Namespace) -> None:
 # -- Services (no --json — these start long-running processes) -------------
+def _cmd_tools(args: Namespace) -> None:
+    from superlocalmemory.cli.tools_cmd import cmd_tools
+    cmd_tools(args)
 def cmd_mcp(_args: Namespace) -> None:
     """Start the V3 MCP server (stdio transport for IDE integration)."""
     from superlocalmemory.mcp.profile_names import exit_on_unknown_profile

superlocalmemory 4.2.4__tar.gz → 4.2.6__tar.gz

superlocalmemory 4.2.4tar.gz → 4.2.6tar.gz