PyPI - superlocalmemory - Versions diffs - 4.2.5__tar.gz → 4.2.7__tar.gz - Mend

superlocalmemory 4.2.5tar.gz → 4.2.7tar.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 (1539) hide show

{superlocalmemory-4.2.5/src/superlocalmemory.egg-info → superlocalmemory-4.2.7}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 4.2.5
+Version: 4.2.7
 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,9 @@ 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)**
+**⭐ If SuperLocalMemory keeps your agents from guessing, [star the repo](https://github.com/qualixar/superlocalmemory/stargazers). It helps other developers find it.**
 <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">
@@ -188,6 +191,8 @@ slm connect claude-code
 slm media enable                  # optional: pictures and documents (about 1.5 GB; needs 16 GB of memory)
 ```
+**uv**: `uv tool install --python 3.12 superlocalmemory` installs `slm` as an isolated tool, with nothing to activate; see [Linux install](docs/install-linux.md#isolated-slm-command-with-uv).
 **Claude Code plugin:** `claude plugin marketplace add qualixar/superlocalmemory`, then `claude plugin install superlocalmemory@qualixar`. **Codex:** `slm connect codex`, then `slm codex install`.
 **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).
@@ -247,12 +252,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 +296,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 +424,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; 5 more while images are on) 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 +452,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
@@ -463,7 +508,7 @@ Cite with [CITATION.cff](https://github.com/qualixar/superlocalmemory/blob/main/
 ## Upgrade
 ```bash
-npm update -g superlocalmemory    # or: pipx upgrade superlocalmemory
+npm update -g superlocalmemory    # or: pipx upgrade superlocalmemory, uv tool upgrade superlocalmemory
 slm restart && slm doctor
 slm upgrade-hosts                 # preview plugin and IDE updates; nothing changes until you --apply
 ```
@@ -481,6 +526,10 @@ Upgrades never move or delete memory, and a store update takes a restore point f
 Python 3.12+, Node 18+ for npm. Pictures and documents need 16 GB of memory.
+## Star history
+<a href="https://star-history.com/#qualixar/superlocalmemory&Date"><img src="https://api.star-history.com/svg?repos=qualixar/superlocalmemory&type=Date" alt="SuperLocalMemory GitHub star history" width="600"></a>
 ## Contributing and license
 Issues and pull requests are welcome: [CONTRIBUTING.md](https://github.com/qualixar/superlocalmemory/blob/main/CONTRIBUTING.md). Security reports: [SECURITY.md](https://github.com/qualixar/superlocalmemory/blob/main/SECURITY.md). Licensed under [AGPL-3.0-or-later](https://github.com/qualixar/superlocalmemory/blob/main/LICENSE); for a commercial license see [COMMERCIAL-LICENSE.md](https://github.com/qualixar/superlocalmemory/blob/main/COMMERCIAL-LICENSE.md).

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/README.md RENAMED Viewed

@@ -1,3 +1,4 @@
+<!-- mcp-name: io.github.qualixar/superlocalmemory -->
 <div align="center">
 <picture>
@@ -19,7 +20,9 @@
 [![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)**
+**⭐ If SuperLocalMemory keeps your agents from guessing, [star the repo](https://github.com/qualixar/superlocalmemory/stargazers). It helps other developers find it.**
 <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">
@@ -72,6 +75,8 @@ slm connect claude-code
 slm media enable                  # optional: pictures and documents (about 1.5 GB; needs 16 GB of memory)
 ```
+**uv**: `uv tool install --python 3.12 superlocalmemory` installs `slm` as an isolated tool, with nothing to activate; see [Linux install](docs/install-linux.md#isolated-slm-command-with-uv).
 **Claude Code plugin:** `claude plugin marketplace add qualixar/superlocalmemory`, then `claude plugin install superlocalmemory@qualixar`. **Codex:** `slm connect codex`, then `slm codex install`.
 **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).
@@ -131,12 +136,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 +180,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 +308,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; 5 more while images are on) 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 +336,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
@@ -347,7 +392,7 @@ Cite with [CITATION.cff](https://github.com/qualixar/superlocalmemory/blob/main/
 ## Upgrade
 ```bash
-npm update -g superlocalmemory    # or: pipx upgrade superlocalmemory
+npm update -g superlocalmemory    # or: pipx upgrade superlocalmemory, uv tool upgrade superlocalmemory
 slm restart && slm doctor
 slm upgrade-hosts                 # preview plugin and IDE updates; nothing changes until you --apply
 ```
@@ -365,6 +410,10 @@ Upgrades never move or delete memory, and a store update takes a restore point f
 Python 3.12+, Node 18+ for npm. Pictures and documents need 16 GB of memory.
+## Star history
+<a href="https://star-history.com/#qualixar/superlocalmemory&Date"><img src="https://api.star-history.com/svg?repos=qualixar/superlocalmemory&type=Date" alt="SuperLocalMemory GitHub star history" width="600"></a>
 ## Contributing and license
 Issues and pull requests are welcome: [CONTRIBUTING.md](https://github.com/qualixar/superlocalmemory/blob/main/CONTRIBUTING.md). Security reports: [SECURITY.md](https://github.com/qualixar/superlocalmemory/blob/main/SECURITY.md). Licensed under [AGPL-3.0-or-later](https://github.com/qualixar/superlocalmemory/blob/main/LICENSE); for a commercial license see [COMMERCIAL-LICENSE.md](https://github.com/qualixar/superlocalmemory/blob/main/COMMERCIAL-LICENSE.md).

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

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

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

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/plugin-src/rules/CLAUDE.md.fragment RENAMED Viewed

@@ -1,4 +1,4 @@
-<!-- BEGIN SuperLocalMemory v4.2.5 -->
+<!-- BEGIN SuperLocalMemory v4.2.7 -->
 ## 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.5 -->
+<!-- END SuperLocalMemory v4.2.7 -->
-SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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.5 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later*

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

@@ -2,7 +2,7 @@
 name: slm-cache
 description: KV cache for repeated reads — call slm_cache_get(key) first; on a miss do the expensive operation then slm_cache_set(key, value, ttl_seconds) to store it; on a hit use the returned value directly; always fail-open (hit:false on any error, never raises); saves tokens when the same file, query result, or tool output is read more than once in a session.
 when_to_use: "cache file, avoid re-reading, repeated read, cache result, cache tool output, save re-read, reuse across session, cache check, cache hit, cache miss"
-allowed-tools: slm_cache_set, slm_cache_get, Bash
+allowed-tools: slm_cache_set, slm_cache_get, Bash(slm:*)
 ---
 # slm-cache — KV Cache for Repeated Reads (Surface B)
@@ -144,4 +144,4 @@ These subcommands control daemon-level cache settings and bulk removal. They do
 ---
-SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

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

@@ -2,7 +2,7 @@
 name: slm-compress
 description: Compress large text, tool output, or transcripts to reduce context-window usage while keeping the full 1M window intact — call slm_compress(content, mode, reversible, ttl_seconds) to shrink content; if the result is lossy a ccr_id is returned so you can call slm_retrieve(ccr_id) later to recover the exact original; always fail-open (ok:false → continue with the original).
 when_to_use: "compress context, shrink output, save tokens, context window full, long transcript, compress tool result, reduce tokens, large output, compress text"
-allowed-tools: slm_compress, slm_retrieve, Bash
+allowed-tools: slm_compress, slm_retrieve, Bash(slm:*)
 ---
 # slm-compress — Reversible Context Compression (Surface B)
@@ -147,4 +147,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
 ---
-SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

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

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

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

@@ -11,7 +11,7 @@ when_to_use: |
   - "The dashboard asks for a key" (slm token show)
   - Enterprise deployment with multi-team shared SLM
   - Compliance, audit, or data governance task
-allowed-tools: audit_trail, set_retention_policy, get_retention_stats, get_lifecycle_status, compact_memories, consistency_check, recall, search, remember, Bash
+allowed-tools: audit_trail, set_retention_policy, get_retention_stats, get_lifecycle_status, compact_memories, consistency_check, recall, search, remember, Bash(slm:*)
 ---
 # slm-governance — Governed Workspace Behavior
@@ -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.
 ---
@@ -112,7 +114,7 @@ a picture or page only when its text held no secret or personal data.
 When login is required, every operation on memories needs a signed-in user,
 including the connection your assistant uses. SLM handles this at the daemon
-level; agents do not pass credentials in tool calls. If a tool call returns an
+level; agents never put credentials in tool calls. If a tool call returns an
 authentication or permission error, you must:
 1. Stop the current operation immediately.
@@ -274,4 +276,4 @@ Before running any destructive or state-changing operation (`forget`,
 ---
-*SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later*

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

@@ -15,12 +15,12 @@ when_to_use: |
   - code navigation in unfamiliar repos
   - blast radius before a PR
   - pre-commit change detection
-allowed-tools: build_code_graph, query_graph, get_blast_radius, semantic_search_code, get_review_context, detect_changes, Bash
+allowed-tools: build_code_graph, query_graph, get_blast_radius, semantic_search_code, get_review_context, detect_changes, Bash(slm:*)
 ---
 # 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.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

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

@@ -2,7 +2,7 @@
 name: slm-loop
 description: Gate-verified bounded loops with SuperLocalMemory as the durable ledger. Use when a task has a checkable acceptance condition and you must iterate until an INDEPENDENT gate passes — never stopping because the agent believes it is done. `slm_loop_run` (MCP) waits, under hard bounds, for an independently executed check registered by the operator to pass; `slm loop demo` shows the control flow keyless; `slm loop history` and `slm loop show <run_id>` (or `slm_loop_history` / `slm_loop_show`) inspect past runs, whose every lap is stored as queryable SLM memory (tag `loop:<name>`). Terminal statuses are DONE / HALT / PAUSE / KILLED / ERROR — report them exactly, never converting HALT/PAUSE/ERROR into success.
 when_to_use: "run a bounded loop, gate-verified task, iterate until tests pass, verify against an independent gate, don't trust the agent's own done claim, slm loop, convergence loop, loop until green, loop ledger, wait for another agent's result"
-allowed-tools: slm_loop_run, slm_loop_history, slm_loop_show, recall, report_outcome, get_soft_prompts, skill_health, skill_lineage, evolve_skill, observe_bounded_loop_evidence, Bash
+allowed-tools: slm_loop_run, slm_loop_history, slm_loop_show, recall, report_outcome, get_soft_prompts, skill_health, skill_lineage, evolve_skill, observe_bounded_loop_evidence, Bash(slm:*)
 ---
 # slm-loop — Bounded, gate-verified agent loops
@@ -171,4 +171,4 @@ Guides: `docs/skill-evolution.md`, `docs/bounded-loops-bridge.md`.
 ---
-SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later

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

@@ -9,7 +9,7 @@ when_to_use: |
   - remember_media, remember_document, get_media, media_status or media_upload_link is missing from the tool list
   - "Turn on pictures and documents", slm media status, slm media repair
   - "Connect my Obsidian vault / notes folder" (slm sources)
-allowed-tools: remember_media, remember_document, get_media, media_status, media_upload_link, recall, Bash
+allowed-tools: remember_media, remember_document, get_media, media_status, media_upload_link, recall, Bash(slm:*)
 ---
 # slm-media — Pictures, PDFs and Folders
@@ -337,4 +337,4 @@ minutes (previous vectors are kept) and let them decide.
 ---
-*SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later*

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

@@ -12,7 +12,7 @@ when_to_use: |
   - "Wait for the other bot's reply" (mesh_wait)
   - A web app (ChatGPT, Claude on the web, Grok Bot, Muse, Composio) should message the owner's other bots
   - Messages come back marked repeat, or ack_ids appear in a reply
-allowed-tools: mesh_summary, mesh_peers, mesh_send, mesh_inbox, mesh_wait, mesh_state, mesh_lock, mesh_events, mesh_status, Bash
+allowed-tools: mesh_summary, mesh_peers, mesh_send, mesh_inbox, mesh_wait, mesh_state, mesh_lock, mesh_events, mesh_status, Bash(slm:*)
 ---
 # slm-mesh — Cross-Session Peer Coordination
@@ -386,4 +386,4 @@ mesh availability.
 ---
-*SuperLocalMemory v4.2.5 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.2.5 → superlocalmemory-4.2.7}/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?"
@@ -10,7 +10,7 @@ when_to_use: |
   - "Why can't I see tool X?"
   - Multi-project workflows needing memory isolation
   - Switching between personal and team workspaces
-allowed-tools: switch_profile, get_status, Bash
+allowed-tools: switch_profile, get_status, Bash(slm:*)
 ---
 # slm-profile — Memory Profiles and Tool Sets
@@ -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 (5 more while images are on) — 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.5 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.2.7 · Qualixar · AGPL-3.0-or-later*

superlocalmemory 4.2.5__tar.gz → 4.2.7__tar.gz

superlocalmemory 4.2.5tar.gz → 4.2.7tar.gz