superlocalmemory 3.6.15 → 3.6.16

package/README.md

@@ -2,10 +2,10 @@
   <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V3.6.15</h1>
+<h1 align="center">SuperLocalMemory V3.6.16</h1>
 <p align="center"><strong>Cache. Compress. Remember. Three surfaces — proxy, MCP tools, or skill. Every setup covered.</strong><br/>
 <em>To the best of our knowledge, the only zero-cloud agent memory that beats Mem0's zero-LLM score on LoCoMo. Mode A: 74.8% vs Mem0 64.2% — no GPU, no API key, on CPU.</em></p>
-<p align="center"><code>v3.6.15</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
+<p align="center"><code>v3.6.16</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
 Proxy: <code>slm wrap claude</code> &nbsp;·&nbsp; MCP: add <code>slm_compress</code> to your config &nbsp;·&nbsp; Skill: zero-config</p>
 <p align="center"><strong>3 published research papers</strong> (arXiv preprints + Zenodo-archived) · <a href="https://arxiv.org/abs/2603.02240">arXiv:2603.02240</a> · <a href="https://arxiv.org/abs/2603.14588">arXiv:2603.14588</a> · <a href="https://arxiv.org/abs/2604.04514">arXiv:2604.04514</a></p>
 
@@ -162,7 +162,7 @@ Full docs: [docs/multi-machine.md](docs/multi-machine.md) · [docs/distributed-d
 |:-----|:--------|:-----|
 | **npm** (recommended) | `npm install -g superlocalmemory` | Node 14+, installs Python deps automatically |
 | **pip** | `pip install superlocalmemory` | Python 3.11+, direct install |
-| **Claude Code Plugin** (WP-06) | `/plugin install superlocalmemory@qualixar` | Self-bootstraps venv, isolated SLM_DATA_DIR, additive — 14-tool core |
+| **Claude Code Plugin** (WP-06) | `/plugin marketplace add qualixar/superlocalmemory` then `/plugin install superlocalmemory@qualixar` | Self-bootstraps venv, isolated SLM_DATA_DIR, additive — 14-tool core. Ships the skills/agents/hooks/commands |
 | **Portable / IDE connect** (WP-08) | `slm connect <ide> [--here]` | Wire any IDE without reinstalling; `slm connect claude-code` → plugin pointer |
 
 After any install path: `slm setup` → `slm doctor` → `slm warmup` (optional, pre-downloads ~500MB embedding model).
@@ -218,18 +218,31 @@ Per-IDE configs available for Claude Code, Cursor, Windsurf, VS Code Copilot, Co
 
 ## Claude Code Plugin
 
-Install directly in Claude Code without a system-level npm/pip install:
+Install directly in Claude Code — no system-level npm/pip needed. This is how you
+get the **skills, agents, hooks, commands, and rules** (the MCP server is
+bootstrapped automatically). It is a two-step flow — add the marketplace once,
+then install:
 
 ```bash
+# 1. Add the Qualixar marketplace (one-time — the repo IS the marketplace)
+/plugin marketplace add qualixar/superlocalmemory
+
+# 2. Install the plugin
 /plugin install superlocalmemory@qualixar
 ```
 
 - Self-bootstraps a Python venv, installs all deps in an isolated `SLM_DATA_DIR`
-- Registers 14-tool core MCP surface (`core14` profile by default)
+- Registers the 14-tool core MCP surface (`core14` profile by default)
+- Ships the SLM skills / agents / hooks / commands / rules
 - Additive — does not replace an existing SLM install
 - `slm connect claude-code` detects an existing plugin install and links them
 
-See [docs/getting-started.md](docs/getting-started.md) for full plugin walkthrough.
+> **Plugin vs `pip`/`npm`:** `pip install superlocalmemory` / `npm i -g superlocalmemory`
+> give you the `slm` CLI + the MCP server (the *tools*). The **skills/agents/hooks/
+> commands** come only through the plugin above. Use the plugin for Claude Code; use
+> pip/npm for the CLI or other IDEs.
+
+To update later: `/plugin marketplace update qualixar` then `/plugin install superlocalmemory@qualixar`.
 
 ---
 
@@ -294,6 +307,7 @@ slm dashboard    # Opens at http://localhost:8765
 
 | Version | Codename | Key Features |
 |---|---|---|
+| **v3.6.16** | Docs | Corrected Claude Code plugin install — adds the required `/plugin marketplace add` step; clarifies plugin vs pip/npm delivery |
 | **v3.6.15** | Multi-scope | **Opt-in [shared memory](docs/shared-memory.md)** (personal/shared/global, off by default), default-deny scope at every read path, recall scope-race fix, contributor PRs #42/#43/#44, fixes #46–#49 |
 | **v3.6.14** | Plugin-native | Claude Code Plugin (WP-06), MCP profiles (WP-01), IDE connect (WP-08), asset consolidation, UI polish (WP-12) |
 | **v3.6.x** | Optimize Everywhere / Distributed-ready | Three surfaces (proxy/MCP/skill), `SLM_REMOTE=1` LAN mode, remote dashboard, custom LLM endpoints |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.6.15",
+  "version": "3.6.16",
   "description": "Information-geometric agent memory with mathematical guarantees. 4-channel retrieval, Fisher-Rao similarity, zero-LLM mode, EU AI Act compliant. Works with Claude, Cursor, Windsurf, and 17+ AI tools.",
   "keywords": [
     "ai-memory",

package/plugin/.claude-plugin/plugin.json

@@ -16,5 +16,5 @@
   "mcpServers": "./.mcp.json",
   "name": "superlocalmemory",
   "repository": "https://github.com/qualixar/superlocalmemory",
-  "version": "3.6.15"
+  "version": "3.6.16"
 }

package/plugin/CLAUDE.md

@@ -1,4 +1,4 @@
-<!-- BEGIN SuperLocalMemory v3.6.15 -->
+<!-- BEGIN SuperLocalMemory v3.6.16 -->
 
 ## SuperLocalMemory (SLM) — Agent Rules
 
@@ -39,6 +39,6 @@ slm-recall · slm-remember · slm-session · slm-status · slm-cache · slm-comp
 ### Subagents
 slm-memory-advisor (memory decisions, session hygiene) · slm-optimize-advisor (context compression + KV cache)
 
-<!-- END SuperLocalMemory v3.6.15 -->
+<!-- END SuperLocalMemory v3.6.16 -->
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/agents/slm-memory-advisor.md

@@ -41,4 +41,4 @@ recall→`slm recall "<q>" --limit N` (add `--include-global`/`--include-shared`
 # What NOT to do
 Never session_init twice; never forget dry_run=False without reporting preview; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/agents/slm-optimize-advisor.md

@@ -35,4 +35,4 @@ stats→`slm optimize status`/`savings` · compress→`slm compress` · cache→
 # 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 %.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/requirements.txt

@@ -1 +1 @@
-superlocalmemory==3.6.15
+superlocalmemory==3.6.16

package/plugin/skills/slm-cache/SKILL.md

@@ -137,4 +137,4 @@ These subcommands control daemon-level cache settings. They do not read or write
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/skills/slm-compress/SKILL.md

@@ -140,4 +140,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/skills/slm-graph/SKILL.md

@@ -297,4 +297,4 @@ Without this, the six graph tools are not registered and will appear as unknown
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin/skills/slm-recall/SKILL.md

@@ -201,4 +201,4 @@ trusts that what you surface came from the store.
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin/skills/slm-remember/SKILL.md

@@ -191,4 +191,4 @@ slm remember "<content>" --scope shared --shared-with alice,bob
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin/skills/slm-session/SKILL.md

@@ -204,4 +204,4 @@ slm doctor [--json]    # preflight check including daemon and embedding worker
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin/skills/slm-status/SKILL.md

@@ -146,4 +146,4 @@ Note: the `slm optimize` subcommands have known pre-existing parse-test failures
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/agents/slm-memory-advisor.md

@@ -41,4 +41,4 @@ recall→`slm recall "<q>" --limit N` (add `--include-global`/`--include-shared`
 # What NOT to do
 Never session_init twice; never forget dry_run=False without reporting preview; never dump a whole file into remember; never invent a memory; never claim "saved" without success:true / clean CLI exit.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/agents/slm-optimize-advisor.md

@@ -35,4 +35,4 @@ stats→`slm optimize status`/`savings` · compress→`slm compress` · cache→
 # 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 %.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/commands/slm-optimize.md

@@ -19,4 +19,4 @@ Rules (apply strictly):
 
 MCP unavailable → CLI fallback: `slm optimize status`.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/commands/slm-recall.md

@@ -13,4 +13,4 @@ Recall from SuperLocalMemory using the query: $ARGUMENTS
    - `slm recall "$ARGUMENTS" --limit 10`
    - then `slm search "$ARGUMENTS"`
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/commands/slm-remember.md

@@ -13,4 +13,4 @@ Save to SuperLocalMemory: $ARGUMENTS
 5. Confirm only on success:true. If success is not true, report the error — never claim "saved."
 6. MCP unavailable → CLI fallback: `slm remember "$ARGUMENTS" --tags <tags>` (note: `--importance` is MCP-only, not a CLI flag).
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/commands/slm-status.md

@@ -12,4 +12,4 @@ Show SuperLocalMemory status and optimization counters.
 
 Note: MCP get_status is intentionally NOT used here — it is outside the core profile and would error. Use `slm status` (CLI) + `slm_optimize_stats` (MCP) only.
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.6.15",
+  "version": "3.6.16",
   "pluginName": "superlocalmemory",
   "displayName": "SuperLocalMemory",
   "repository": "https://github.com/qualixar/superlocalmemory",

package/plugin-src/requirements.txt

@@ -1 +1 @@
-superlocalmemory==3.6.15
+superlocalmemory==3.6.16

package/plugin-src/rules/AGENTS.md

@@ -88,4 +88,4 @@ When the SLM MCP server is unavailable, use these CLI equivalents:
 | `slm_cache_get`    | `key`                                                                          | KV cache get; returns hit, value   |
 | `slm_optimize_stats` | `()`                                                                         | Returns compress_runs, tokens_saved_compress, cache_kv_hits |
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/rules/CLAUDE.md.fragment

@@ -1,4 +1,4 @@
-<!-- BEGIN SuperLocalMemory v3.6.15 -->
+<!-- BEGIN SuperLocalMemory v3.6.16 -->
 
 ## SuperLocalMemory (SLM) — Agent Rules
 
@@ -39,6 +39,6 @@ slm-recall · slm-remember · slm-session · slm-status · slm-cache · slm-comp
 ### Subagents
 slm-memory-advisor (memory decisions, session hygiene) · slm-optimize-advisor (context compression + KV cache)
 
-<!-- END SuperLocalMemory v3.6.15 -->
+<!-- END SuperLocalMemory v3.6.16 -->
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/skills/slm-cache/SKILL.md

@@ -137,4 +137,4 @@ These subcommands control daemon-level cache settings. They do not read or write
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/skills/slm-compress/SKILL.md

@@ -140,4 +140,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/skills/slm-graph/SKILL.md

@@ -297,4 +297,4 @@ Without this, the six graph tools are not registered and will appear as unknown
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/plugin-src/skills/slm-recall/SKILL.md

@@ -201,4 +201,4 @@ trusts that what you surface came from the store.
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin-src/skills/slm-remember/SKILL.md

@@ -191,4 +191,4 @@ slm remember "<content>" --scope shared --shared-with alice,bob
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin-src/skills/slm-session/SKILL.md

@@ -204,4 +204,4 @@ slm doctor [--json]    # preflight check including daemon and embedding worker
 
 ---
 
-*SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later*

package/plugin-src/skills/slm-status/SKILL.md

@@ -146,4 +146,4 @@ Note: the `slm optimize` subcommands have known pre-existing parse-test failures
 
 ---
 
-SuperLocalMemory v3.6.15 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v3.6.16 · Qualixar · AGPL-3.0-or-later

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.6.15"
+version = "3.6.16"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "AGPL-3.0-or-later"}

package/scripts/build-plugin.js

@@ -30,7 +30,7 @@ import process from 'node:process';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-const VERSION = '3.6.15';
+const VERSION = '3.6.16';
 const MANIFEST_REL = 'plugin-src/manifest.json';
 const GENERATED_BANNER = `# _GENERATED — DO NOT HAND-EDIT
 

package/src/superlocalmemory/__init__.py

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

package/src/superlocalmemory.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.6.15
+Version: 3.6.16
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -96,10 +96,10 @@ Dynamic: license-file
   <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V3.6.15</h1>
+<h1 align="center">SuperLocalMemory V3.6.16</h1>
 <p align="center"><strong>Cache. Compress. Remember. Three surfaces — proxy, MCP tools, or skill. Every setup covered.</strong><br/>
 <em>To the best of our knowledge, the only zero-cloud agent memory that beats Mem0's zero-LLM score on LoCoMo. Mode A: 74.8% vs Mem0 64.2% — no GPU, no API key, on CPU.</em></p>
-<p align="center"><code>v3.6.15</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
+<p align="center"><code>v3.6.16</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
 Proxy: <code>slm wrap claude</code> &nbsp;·&nbsp; MCP: add <code>slm_compress</code> to your config &nbsp;·&nbsp; Skill: zero-config</p>
 <p align="center"><strong>3 published research papers</strong> (arXiv preprints + Zenodo-archived) · <a href="https://arxiv.org/abs/2603.02240">arXiv:2603.02240</a> · <a href="https://arxiv.org/abs/2603.14588">arXiv:2603.14588</a> · <a href="https://arxiv.org/abs/2604.04514">arXiv:2604.04514</a></p>
 
@@ -256,7 +256,7 @@ Full docs: [docs/multi-machine.md](docs/multi-machine.md) · [docs/distributed-d
 |:-----|:--------|:-----|
 | **npm** (recommended) | `npm install -g superlocalmemory` | Node 14+, installs Python deps automatically |
 | **pip** | `pip install superlocalmemory` | Python 3.11+, direct install |
-| **Claude Code Plugin** (WP-06) | `/plugin install superlocalmemory@qualixar` | Self-bootstraps venv, isolated SLM_DATA_DIR, additive — 14-tool core |
+| **Claude Code Plugin** (WP-06) | `/plugin marketplace add qualixar/superlocalmemory` then `/plugin install superlocalmemory@qualixar` | Self-bootstraps venv, isolated SLM_DATA_DIR, additive — 14-tool core. Ships the skills/agents/hooks/commands |
 | **Portable / IDE connect** (WP-08) | `slm connect <ide> [--here]` | Wire any IDE without reinstalling; `slm connect claude-code` → plugin pointer |
 
 After any install path: `slm setup` → `slm doctor` → `slm warmup` (optional, pre-downloads ~500MB embedding model).
@@ -312,18 +312,31 @@ Per-IDE configs available for Claude Code, Cursor, Windsurf, VS Code Copilot, Co
 
 ## Claude Code Plugin
 
-Install directly in Claude Code without a system-level npm/pip install:
+Install directly in Claude Code — no system-level npm/pip needed. This is how you
+get the **skills, agents, hooks, commands, and rules** (the MCP server is
+bootstrapped automatically). It is a two-step flow — add the marketplace once,
+then install:
 
 ```bash
+# 1. Add the Qualixar marketplace (one-time — the repo IS the marketplace)
+/plugin marketplace add qualixar/superlocalmemory
+
+# 2. Install the plugin
 /plugin install superlocalmemory@qualixar
 ```
 
 - Self-bootstraps a Python venv, installs all deps in an isolated `SLM_DATA_DIR`
-- Registers 14-tool core MCP surface (`core14` profile by default)
+- Registers the 14-tool core MCP surface (`core14` profile by default)
+- Ships the SLM skills / agents / hooks / commands / rules
 - Additive — does not replace an existing SLM install
 - `slm connect claude-code` detects an existing plugin install and links them
 
-See [docs/getting-started.md](docs/getting-started.md) for full plugin walkthrough.
+> **Plugin vs `pip`/`npm`:** `pip install superlocalmemory` / `npm i -g superlocalmemory`
+> give you the `slm` CLI + the MCP server (the *tools*). The **skills/agents/hooks/
+> commands** come only through the plugin above. Use the plugin for Claude Code; use
+> pip/npm for the CLI or other IDEs.
+
+To update later: `/plugin marketplace update qualixar` then `/plugin install superlocalmemory@qualixar`.
 
 ---
 
@@ -388,6 +401,7 @@ slm dashboard    # Opens at http://localhost:8765
 
 | Version | Codename | Key Features |
 |---|---|---|
+| **v3.6.16** | Docs | Corrected Claude Code plugin install — adds the required `/plugin marketplace add` step; clarifies plugin vs pip/npm delivery |
 | **v3.6.15** | Multi-scope | **Opt-in [shared memory](docs/shared-memory.md)** (personal/shared/global, off by default), default-deny scope at every read path, recall scope-race fix, contributor PRs #42/#43/#44, fixes #46–#49 |
 | **v3.6.14** | Plugin-native | Claude Code Plugin (WP-06), MCP profiles (WP-01), IDE connect (WP-08), asset consolidation, UI polish (WP-12) |
 | **v3.6.x** | Optimize Everywhere / Distributed-ready | Three surfaces (proxy/MCP/skill), `SLM_REMOTE=1` LAN mode, remote dashboard, custom LLM endpoints |