omo-memory 0.1.5 → 0.1.7

package/README.md

@@ -67,7 +67,7 @@ Both hosts use the current project ledger at `<project-root>/.omo/memory/state.s
 
 ## Passive setup
 
-Install passive skills/rules/hooks with:
+Install the host plugin-style bundles with:
 
 ```sh
 npx -y omo-memory hooks install --host all
@@ -76,7 +76,7 @@ npx -y omo-memory hooks install --host all
 This installs:
 
 - Codex: `~/.codex/skills/omo-memory/SKILL.md`, a global `~/.codex/AGENTS.md` lifecycle rule, and a local Codex plugin with a `SessionStart` hook.
-- Grok: `~/.grok/skills/omo-memory/SKILL.md`, a global `~/.grok/AGENTS.md` lifecycle rule, and a `~/.grok/hooks/` SessionStart hook.
+- Grok: `~/.grok/plugins/omo-memory` with `plugin.json`, skill, `SessionStart` hook, and `.mcp.json`, plus compatibility copies in `~/.grok/skills` and `~/.grok/hooks`.
 
 The installer is idempotent. For Codex it also runs `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory.
 

package/dist/hookTemplates.js

@@ -82,9 +82,34 @@ try {
 }
 `;
 export const GROK_HOOK_SCRIPT = SESSION_BOOTSTRAP_SCRIPT.replace('?? "codex"', '?? "grok"').replace('?? "lazycodex"', '?? "lfg"');
+export const GROK_PLUGIN_JSON = `{
+  "name": "omo-memory",
+  "version": "0.1.7",
+  "description": "Project-local OMO Memory bootstrap hook and MCP server for Grok.",
+  "author": {
+    "name": "islee23520"
+  },
+  "repository": "https://github.com/islee23520/omo-memory",
+  "homepage": "https://github.com/islee23520/omo-memory",
+  "license": "MIT",
+  "keywords": ["grok", "hooks", "memory", "mcp"],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json"
+}
+`;
+export const GROK_MCP_JSON = `{
+  "mcpServers": {
+    "omo-memory": {
+      "command": "npx",
+      "args": ["-y", "omo-memory", "mcp"]
+    }
+  }
+}
+`;
 export const CODEX_PLUGIN_JSON = `{
   "name": "omo-memory",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Session-start OMO Memory bootstrap hook for Codex.",
   "author": "islee23520",
   "homepage": "https://github.com/islee23520/omo-memory",

package/dist/hooks.js

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { CODEX_AGENTS_BLOCK, CODEX_HOOKS_JSON, CODEX_MARKETPLACE, CODEX_PLUGIN, CODEX_PLUGIN_JSON, CODEX_SKILL, GROK_AGENTS_BLOCK, GROK_HOOK_SCRIPT, GROK_HOOKS_JSON, GROK_SKILL, SESSION_BOOTSTRAP_SCRIPT, } from "./hookTemplates.js";
+import { CODEX_AGENTS_BLOCK, CODEX_HOOKS_JSON, CODEX_MARKETPLACE, CODEX_PLUGIN, CODEX_PLUGIN_JSON, CODEX_SKILL, GROK_AGENTS_BLOCK, GROK_HOOK_SCRIPT, GROK_HOOKS_JSON, GROK_MCP_JSON, GROK_PLUGIN_JSON, GROK_SKILL, SESSION_BOOTSTRAP_SCRIPT, } from "./hookTemplates.js";
 const BLOCK_START = "<!-- omo-memory:start -->";
 const BLOCK_END = "<!-- omo-memory:end -->";
 export function installHooks(input) {
@@ -58,15 +58,28 @@ function installGrok(home) {
     const agentsPath = join(home, ".grok", "AGENTS.md");
     const hookScriptPath = join(home, ".grok", "hooks", "omo-memory-session.mjs");
     const hookJsonPath = join(home, ".grok", "hooks", "omo-memory-hooks.json");
+    const pluginRoot = join(home, ".grok", "plugins", "omo-memory");
+    const pluginJsonPath = join(pluginRoot, "plugin.json");
+    const pluginSkillPath = join(pluginRoot, "skills", "omo-memory", "SKILL.md");
+    const pluginHookJsonPath = join(pluginRoot, "hooks", "hooks.json");
+    const pluginHookScriptPath = join(pluginRoot, "scripts", "omo-memory-session.mjs");
+    const pluginMcpPath = join(pluginRoot, ".mcp.json");
     writeText(skillPath, GROK_SKILL);
     upsertAgentsBlock(agentsPath, GROK_AGENTS_BLOCK);
     writeText(hookScriptPath, GROK_HOOK_SCRIPT);
     chmodSync(hookScriptPath, 0o755);
     writeText(hookJsonPath, GROK_HOOKS_JSON.replace("{{HOME}}", home));
+    writeText(pluginJsonPath, GROK_PLUGIN_JSON);
+    writeText(pluginSkillPath, GROK_SKILL);
+    writeText(pluginHookJsonPath, GROK_HOOKS_JSON.replace(`node \\"{{HOME}}/.grok/hooks/omo-memory-session.mjs\\"`, `node \\"${pluginHookScriptPath}\\"`));
+    writeText(pluginHookScriptPath, GROK_HOOK_SCRIPT);
+    chmodSync(pluginHookScriptPath, 0o755);
+    writeText(pluginMcpPath, GROK_MCP_JSON);
+    const pluginInstallNote = maybeInstallGrokPlugin(home, pluginRoot);
     return {
         host: "grok",
-        files: [skillPath, agentsPath, hookScriptPath, hookJsonPath],
-        notes: ["Grok discovers ~/.grok/skills and ~/.grok/hooks; run grok inspect to verify discovery."],
+        files: [skillPath, agentsPath, hookScriptPath, hookJsonPath, pluginJsonPath, pluginSkillPath, pluginHookJsonPath, pluginHookScriptPath, pluginMcpPath],
+        notes: ["Grok plugin bundle installed at ~/.grok/plugins/omo-memory.", pluginInstallNote],
     };
 }
 function writeText(path, text) {
@@ -135,6 +148,19 @@ function maybeInstallCodexPlugin(home) {
     const detail = result.error instanceof Error ? result.error.message : result.stderr.trim();
     return `Could not run \`codex plugin add omo-memory@islee23520 --json\`: ${detail || "unknown error"}. Run it manually if Codex still reports the plugin as not installed.`;
 }
+function maybeInstallGrokPlugin(home, pluginRoot) {
+    if (home !== homedir())
+        return "Skipped `grok plugin install` because OMO_MEMORY_INSTALL_HOME points at a test/alternate home.";
+    const result = spawnSync("grok", ["plugin", "install", pluginRoot, "--trust"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        timeout: 15000,
+    });
+    if (result.status === 0)
+        return "`grok plugin install ~/.grok/plugins/omo-memory --trust` completed successfully.";
+    const detail = result.error instanceof Error ? result.error.message : result.stderr.trim();
+    return `Could not run \`grok plugin install ~/.grok/plugins/omo-memory --trust\`: ${detail || "unknown error"}. Run it manually if Grok still reports the plugin as not installed.`;
+}
 function ensureTomlKey(text, table, keyValue) {
     if (text.includes(keyValue))
         return text;

package/docs/adapter-integration.md

@@ -83,7 +83,7 @@ grok mcp add omo-memory -- npx -y omo-memory mcp
 
 Register the same MCP server in every host that needs memory access. Do not create separate Codex/Grok schemas or databases; host identity belongs in `memory_start_session` metadata.
 
-## Passive Hook Install
+## Plugin-Style Host Install
 
 Install host-side passive behavior with:
 
@@ -94,10 +94,10 @@ npx -y omo-memory hooks install --host all
 Supported `--host` values:
 
 - `codex`: installs `~/.codex/skills/omo-memory/SKILL.md`, an idempotent OMO Memory block in `~/.codex/AGENTS.md`, and a local Codex plugin with a `SessionStart` hook.
-- `grok`: installs `~/.grok/skills/omo-memory/SKILL.md`, an idempotent OMO Memory block in `~/.grok/AGENTS.md`, and `~/.grok/hooks/omo-memory-hooks.json` plus its SessionStart script.
+- `grok`: installs `~/.grok/plugins/omo-memory` with `plugin.json`, a bundled skill, `hooks/hooks.json`, `.mcp.json`, and a SessionStart script. It also writes compatibility copies to `~/.grok/skills` and `~/.grok/hooks`.
 - `all`: installs both.
 
-The installer is idempotent and replaces only the marked `omo-memory` block in AGENTS files. For Codex it also registers the local plugin with `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory.
+The installer is idempotent and replaces only the marked `omo-memory` block in AGENTS files. For Codex it also registers the local plugin with `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory. For Grok, `~/.grok/plugins/omo-memory` is a user plugin and is trusted automatically by Grok.
 
 ## Session Bootstrap Flow
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omo-memory",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Host-neutral local SQLite memory and session ledger for OMO adapters, exposed through CLI and MCP.",
   "type": "module",
   "files": [