Merge pull request #310 from nowledge-co/dev_0916

0916: grok build support and Hermes stale plugin issue

Author: wey-gu

.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
   "plugins": [
     {
       "name": "nowledge-mem",
-      "description": "Personal knowledge graph for Claude Code — remembers decisions, searches past work, captures sessions",
-      "version": "0.7.10",
+      "description": "Personal knowledge graph for Claude Code and Grok — remembers decisions, searches past work, captures sessions",
+      "version": "0.7.12",
       "author": {
         "name": "Nowledge Labs",
         "url": "https://www.nowledge-labs.ai/",

README.md

@@ -46,6 +46,7 @@ Each directory is a standalone integration. Pick the one that matches your tool.
 |-------------|---------|--------------|
 | **[Skills](nowledge-mem-npx-skills)** | `npx skills add nowledge-co/community/nowledge-mem-npx-skills` | Reusable workflow package for Context Bundle / Working Memory startup context, routed recall, resumable handoffs, and distillation. Prefer native packages when your tool has one. |
 | **[Claude Code Plugin](nowledge-mem-claude-code-plugin)** | `claude plugin marketplace add https://github.com/nowledge-co/community` then `claude plugin install nowledge-mem@nowledge-community` | Claude Code native plugin with hooks for Context Bundle / Working Memory startup context, routed recall, automatic session capture, and pre-compaction transcript save. |
+| **[Grok Build Plugin](nowledge-mem-claude-code-plugin)** | `grok plugin install nowledge-co/community#nowledge-mem-claude-code-plugin --trust` | Grok loads the shared Claude-compatible package, with Grok-aware Context Bundle startup and `nmem t save --from grok` session capture. |
 | **[Copilot CLI Plugin](nowledge-mem-copilot-cli-plugin)** | `copilot plugin marketplace add nowledge-co/community` then `copilot plugin install nowledge-mem@nowledge-community` | GitHub Copilot CLI plugin with startup context guidance, routed recall, incremental session capture, and pre-compaction transcript save. |
 | **[Droid Plugin](nowledge-mem-droid-plugin)** | `droid plugin marketplace add https://github.com/nowledge-co/community` then `droid plugin install nowledge-mem@nowledge-community` | Factory Droid plugin with Context Bundle / Working Memory startup context, routed recall, distillation, and honest `save-handoff` semantics. |
 | **[Gemini CLI](https://github.com/nowledge-co/nowledge-mem-gemini-cli)** | Search `Nowledge Mem` in the [Gemini CLI Extensions Gallery](https://geminicli.com/extensions/?name=nowledge-co/nowledge-mem-gemini-cli) and install | Gemini-native context, bundled MCP, hooks, commands, and skills for Context Bundle / Working Memory startup context, routed recall, real thread save before compression or exit, and handoff summaries. |
@@ -129,7 +130,7 @@ Use one ambient space only when the host already has a real lane, such as one AI
 
 | Integration | Ambient space today | Best user setup |
 |-------------|---------------------|-----------------|
-| Claude Code, Codex, Droid, Pi, Gemini CLI | Full ambient lane through `NMEM_SPACE` or per-command `--space` | Set one `NMEM_SPACE` only when the whole session truly belongs to one lane. Otherwise stay on `Default`. |
+| Claude Code, Grok, Codex, Droid, Pi, Gemini CLI | Full ambient lane through `NMEM_SPACE` or per-command `--space` | Set one `NMEM_SPACE` only when the whole session truly belongs to one lane. Otherwise stay on `Default`. |
 | Hermes | Full ambient lane through provider `space`, `space_by_identity`, `space_template`, or fallback `NMEM_SPACE` | Use `space` for one stable lane, `space_by_identity` for a small explicit map, `space_template` for one lane per Hermes identity. |
 | Alma | Full ambient lane through plugin `nowledgeMem.space`, plugin `nowledgeMem.spaceTemplate`, or fallback `NMEM_SPACE` | Use `space` for one Alma profile per lane. Use `spaceTemplate` only when your launcher already exports a trustworthy lane variable. |
 | Bub | Full ambient lane through `NMEM_SPACE` | Treat Bub as one process-wide lane. If you need separate lanes, run separate Bub processes or profiles. |

docker/README.md

@@ -327,7 +327,7 @@ public keys to download or rotate — verification uses the GitHub Actions OIDC
 identity that produced the build.
 
 ```bash
-cosign verify docker.io/nowledgelabs/mem:0.9.15 \
+cosign verify docker.io/nowledgelabs/mem:latest \
   --certificate-identity-regexp='https://github.com/nowledge-co/mem/.github/workflows/release-docker.yml@.*' \
   --certificate-oidc-issuer='https://token.actions.githubusercontent.com'
 ```
@@ -358,7 +358,7 @@ The image ships a multi-arch manifest for **`linux/amd64`** and
 If you need a specific arch, pin it explicitly:
 
 ```bash
-docker pull --platform linux/amd64 docker.io/nowledgelabs/mem:0.9.15
+docker pull --platform linux/amd64 docker.io/nowledgelabs/mem:latest
 ```
 
 ---

docker/compose.yaml

@@ -22,7 +22,7 @@
 #   NMEM_COMPOSE_FILES='-f compose.yaml -f compose.tls.yaml' ./nmemctl up
 #
 # Verify the image is signed by Nowledge Labs (anyone, anywhere):
-#   cosign verify docker.io/nowledgelabs/mem:0.9.15 \
+#   cosign verify docker.io/nowledgelabs/mem:latest \
 #     --certificate-identity-regexp='https://github.com/nowledge-co/mem/.github/workflows/release-docker.yml@.*' \
 #     --certificate-oidc-issuer='https://token.actions.githubusercontent.com'
 
@@ -32,7 +32,7 @@ services:
     # optional `./nmemctl auto-update` sidecar can flip versions by
     # writing `NMEM_IMAGE_TAG=<ver>` to `.env` (mode 0600, gitignored)
     # without rewriting this file. Fresh installs use the default.
-    image: docker.io/nowledgelabs/mem:${NMEM_IMAGE_TAG:-0.9.15}
+    image: docker.io/nowledgelabs/mem:${NMEM_IMAGE_TAG:-0.9.16}
     container_name: nowledge-mem
     restart: unless-stopped
     labels:

docs/USER_OVERRIDE_GUIDE.md

@@ -14,6 +14,7 @@ Use the host's own user-owned instruction surface instead. That is the only over
 |------|-------------------------------|-----------------------------------|-------|
 | Codex | `AGENTS.md` | same `AGENTS.md` in the repo you care about | The package `AGENTS.md` is source text to merge, not a file to patch under the installed plugin. |
 | Claude Code | `CLAUDE.md` | `CLAUDE.local.md` | Prefer `CLAUDE.local.md` for your own memory-behavior tweaks that should not enter git. |
+| Grok | Grok project rules / `Agents.md` | repo-local project rules | Keep installed plugin files untouched; put behavior changes in the project rules Grok already reads. |
 | Copilot CLI | `.github/copilot-instructions.md` or `.github/instructions/*.instructions.md` | `~/.copilot/copilot-instructions.md` | Use Copilot's native instruction picker and file discovery instead of editing plugin hooks. |
 | Cursor | `.cursor/rules/*.mdc` or `.cursorrules` | repo-local rule files | Keep the plugin's bundled rule as the default. Add your own rule file beside it. |
 | Gemini CLI | `GEMINI.md` in the repo root | `~/.gemini/GEMINI.md` | Use `@file.md` imports to keep large customizations modular. |

integrations.json

@@ -8,7 +8,7 @@
     "promptZh": "读取 https://mem.nowledge.co/SKILL.md，按其中说明为我当前使用的 AI 工具安装或更新 Nowledge Mem。",
     "designDoc": "https://github.com/nowledge-co/mem/blob/main/docs/design/ONBOARDING_REVISIT_0_9_0.md",
     "appliesTo": [
-      "claude-code", "codex-cli", "cursor", "gemini-cli", "copilot-cli",
+      "claude-code", "grok", "codex-cli", "cursor", "gemini-cli", "copilot-cli",
       "openclaw", "hermes", "droid", "alma", "bub", "pi", "opencode",
       "claude-desktop", "proma", "slock", "lody", "multica", "cumora", "mcp-direct"
     ],
@@ -20,7 +20,7 @@
       "name": "Claude Code",
       "category": "coding",
       "type": "plugin",
-      "version": "0.7.10",
+      "version": "0.7.12",
       "directory": "nowledge-mem-claude-code-plugin",
       "transport": "cli",
       "capabilities": {
@@ -67,6 +67,59 @@
       "skills": ["read-working-memory", "search-memory", "distill-memory", "save-thread"],
       "slashCommands": ["/save", "/search", "/sum", "/status"]
     },
+    {
+      "id": "grok",
+      "name": "Grok Build",
+      "category": "coding",
+      "type": "plugin",
+      "version": "0.7.12",
+      "directory": "nowledge-mem-claude-code-plugin",
+      "transport": "cli",
+      "capabilities": {
+        "workingMemory": true,
+        "search": true,
+        "distill": true,
+        "autoRecall": true,
+        "autoCapture": true,
+        "graphExploration": false,
+        "status": true
+      },
+      "threadSave": {
+        "method": "cli-native",
+        "runtime": "grok",
+        "command": "nmem t save --from grok",
+        "historicalCommand": "nmem t sync --from grok --all-projects",
+        "note": "Grok Build loads Claude-compatible plugin assets. The shared Nowledge Mem hook detects Grok Build's hook environment and routes Context Bundle reads and transcript capture as source_app=grok."
+      },
+      "autonomy": {
+        "bootstrap": "automatic",
+        "recall": "guided",
+        "distill": "guided",
+        "threads": "automatic-capture",
+        "bestResultRequires": [
+          "Install the Grok Build plugin from the community repository subdirectory",
+          "Keep nmem available on this machine",
+          "Restart Grok Build after install or update",
+          "Run nmem t sync --from grok --all-projects --apply only when you want to import older Grok Build sessions"
+        ]
+      },
+      "install": {
+        "command": "grok plugin install nowledge-co/community#nowledge-mem-claude-code-plugin --trust",
+        "updateCommand": "grok plugin update nowledge-mem",
+        "detectionHint": "Running as Grok Build; ~/.grok/ exists",
+        "agentGuide": {
+          "prompt": "Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Grok Build. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.",
+          "promptZh": "读取 https://mem.nowledge.co/SKILL.md，按其中说明为 Grok Build 安装或更新 Nowledge Mem。用 nmem status 和 Context Bundle 或 Working Memory 检查验证结果，并总结你改了什么。"
+        },
+        "docsUrl": "/docs/integrations/grok"
+      },
+      "toolNaming": {
+        "convention": "cli-direct",
+        "note": "Grok Build loads the shared Claude-compatible plugin package; hook scripts detect Grok Build and call nmem with source_app=grok."
+      },
+      "skills": ["read-working-memory", "search-memory", "distill-memory", "save-thread"],
+      "slashCommands": ["/save", "/search", "/sum", "/status"]
+    },
     {
       "id": "copilot-cli",
       "name": "Copilot CLI",
@@ -732,7 +785,7 @@
       "name": "Hermes Agent",
       "category": "coding",
       "type": "plugin",
-      "version": "0.5.17",
+      "version": "0.5.18",
       "directory": "nowledge-mem-hermes",
       "transport": "cli",
       "capabilities": {

nowledge-mem-claude-code-plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "nowledge-mem",
-  "description": "Personal knowledge graph for Claude Code \u2014 remembers decisions, searches past work, captures sessions",
-  "version": "0.7.10",
+  "description": "Personal knowledge graph for Claude Code and Grok \u2014 remembers decisions, searches past work, captures sessions",
+  "version": "0.7.12",
   "author": {
     "name": "Nowledge Labs",
     "email": "hello@nowledge-labs.ai",

nowledge-mem-claude-code-plugin/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to the Nowledge Mem Claude Code plugin will be documented in
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.12] - 2026-06-18
+
+### Fixed
+
+- Grok Build hook routing now also treats `GROK_PLUGIN_ROOT` as a Grok Build runtime signal. This keeps Context Bundle reads and automatic transcript capture labeled as Grok Build even on hook launches that only expose the plugin root.
+
+## [0.7.11] - 2026-06-18
+
+### Added
+
+- Added Grok Build-aware hook routing. When Grok Build runs the plugin through its Claude-compatible plugin layer, Context Bundle reads now use `--source-app grok` and automatic capture uses `nmem t save --from grok`.
+
+### Fixed
+
+- Grok Build sessions no longer get mislabeled as Claude Code sessions when the shared hook package is loaded by Grok Build.
+
 ## [0.7.10] - 2026-05-20
 
 ### Changed

nowledge-mem-claude-code-plugin/README.md

@@ -1,9 +1,11 @@
-# Nowledge Mem -- Claude Code Plugin
+# Nowledge Mem -- Claude Code / Grok Build Plugin
 
-> Your personal knowledge graph, built into Claude Code. Claude remembers your decisions, searches past work, and captures sessions -- without you asking.
+> Your personal knowledge graph, built into Claude Code and Grok Build. Your agent remembers decisions, searches past work, and captures sessions -- without you asking.
 
 ## Install
 
+Claude Code:
+
 ```bash
 # Add the Nowledge community marketplace
 claude plugin marketplace add https://github.com/nowledge-co/community
@@ -12,6 +14,12 @@ claude plugin marketplace add https://github.com/nowledge-co/community
 claude plugin install nowledge-mem@nowledge-community
 ```
 
+Grok Build:
+
+```bash
+grok plugin install nowledge-co/community#nowledge-mem-claude-code-plugin --trust
+```
+
 **Prerequisite:** `nmem` CLI must be in your PATH. Hook capture also needs `python3` or `python` available on the same machine:
 
 ```bash
@@ -71,12 +79,12 @@ This calls the Windows `nmem` via interop — no extra setup or network configur
 | `SessionStart` | New, resume, or clear | Loads Context Bundle via `nmem context`, then falls back to `nmem wm read` |
 | `SessionStart` | After compaction | Re-loads Context Bundle or Working Memory + checkpoint prompt |
 | `UserPromptSubmit` | Every user message | Injects search/save syntax as context |
-| `PreCompact` | Before manual or automatic compaction | Saves the exact Claude Code session by hook `session_id` before context is compressed |
+| `PreCompact` | Before manual or automatic compaction | Saves the exact Claude Code or Grok Build session by hook `session_id` before context is compressed |
 | `Stop` | Model finishes responding | Captures session to knowledge graph |
 
 The `SessionStart` hook tries `nmem context` first so Claude receives owner identity, AI Identity, active space, active rules, Working Memory, and KFS paths when the installed CLI supports it. It falls back to `nmem wm read`, then to `~/ai-now/memory.md` only as the **Default-space** compatibility path.
 
-The `PreCompact` hook runs the same client-side thread save before Claude Code compresses the context. The `Stop` hook runs it again after every response with a bounded retry window, so short transcript-flush delays do not turn into silent no-op saves. Both paths pass Claude's hook `session_id` into `nmem t save`, so concurrent sessions in the same project do not have to rely on "latest session" guessing.
+The `PreCompact` hook runs the same client-side thread save before the host compresses context. The `Stop` hook runs it again after every response with a bounded retry window, so short transcript-flush delays do not turn into silent no-op saves. Claude Code uses `nmem t save --from claude-code`; Grok Build uses `nmem t save --from grok`. Both paths pass the host session id into `nmem t save`, so concurrent sessions in the same project do not have to rely on "latest session" guessing.
 
 If the desktop app's Claude Code file watcher is also enabled, you can leave it on. The watcher and plugin hooks converge on the same `claude-code-<sessionId>` thread, so repeated saves update the existing thread instead of creating a second one.
 
@@ -102,12 +110,16 @@ Automatic capture starts after the plugin and hooks are installed. To backfill o
 
 ```bash
 nmem t sync --from claude-code --all-projects --limit 20
+# Grok Build:
+nmem t sync --from grok --all-projects --limit 20
 ```
 
 Then import:
 
 ```bash
 nmem t sync --from claude-code --all-projects --apply
+# Grok Build:
+nmem t sync --from grok --all-projects --apply
 ```
 
 Use `-p /path/to/project` instead of `--all-projects` when you only want one project. The command reads local Claude Code session files and writes to the Mem server configured in `nmem`.

nowledge-mem-claude-code-plugin/commands/save.md

@@ -4,14 +4,16 @@ description: Save current session to Nowledge Mem
 
 # Save Session
 
-Save the current Claude Code session to Nowledge Mem using the nmem CLI.
+Save the current Claude Code or Grok Build session to Nowledge Mem using the nmem CLI.
 
 ## Usage
 
-Run this command to save the current session:
+Run the command for your current host:
 
 ```bash
 nmem t save --from claude-code
+# In Grok Build:
+nmem t save --from grok
 ```
 
 ## Options
@@ -20,18 +22,22 @@ Add a summary describing what was accomplished:
 
 ```bash
 nmem t save --from claude-code -s "Brief summary of the session"
+# In Grok Build:
+nmem t save --from grok -s "Brief summary of the session"
 ```
 
 Save all sessions for the current project:
 
 ```bash
 nmem t save --from claude-code -m all
+# In Grok Build:
+nmem t save --from grok -m all
 ```
 
 ## Output
 
 The command will:
-- Auto-detect the current project from `~/.claude/projects/`
+- Auto-detect the current project from `~/.claude/projects/` or Grok Build's `~/.grok/sessions/`
 - Import all messages from the session
 - Return the thread ID for reference