omo-memory 0.1.4 → 0.1.6

package/README.md

@@ -9,7 +9,7 @@ It gives lazycodex, omo-on-opencode, lfg, and future OMO adapters a shared local
 
 ## Product shape
 
-- Global local DB: `~/.omo/memory/state.sqlite`
+- Project-local DB: `<project-root>/.omo/memory/state.sqlite`
 - Project namespacing: by git remote + project root hash
 - Privacy default: local-only, no network sync, no secrets by design
 - Intended adapters: Codex/lazycodex, OpenCode/OMO, GrokBuild/lfg
@@ -49,7 +49,7 @@ omo-memory init
 
 ## MCP registration
 
-Register the same MCP server in every host that should read/write the shared local memory DB.
+Register the same MCP server in every host that should read/write the current project's memory DB.
 
 Codex:
 
@@ -63,11 +63,11 @@ Grok:
 grok mcp add omo-memory -- npx -y omo-memory mcp
 ```
 
-Both hosts use `~/.omo/memory/state.sqlite` by default. The `host` value is recorded when an adapter calls `memory_start_session`, not by installing separate servers.
+Both hosts use the current project ledger at `<project-root>/.omo/memory/state.sqlite` by default. The `host` value is recorded when an adapter calls `memory_start_session`, not by installing separate servers.
 
 ## Passive setup
 
-Install passive skills/rules/hooks with:
+Install the host plugin-style bundles with:
 
 ```sh
 npx -y omo-memory hooks install --host all
@@ -75,10 +75,10 @@ npx -y omo-memory hooks install --host all
 
 This installs:
 
-- Codex: `~/.codex/skills/omo-memory/SKILL.md` plus a global `~/.codex/AGENTS.md` lifecycle rule.
-- Grok: `~/.grok/skills/omo-memory/SKILL.md`, a global `~/.grok/AGENTS.md` lifecycle rule, and a `~/.grok/hooks/` SessionStart hook.
+- 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/plugins/omo-memory` with `plugin.json`, skill, `SessionStart` hook, and `.mcp.json`, plus compatibility copies in `~/.grok/skills` and `~/.grok/hooks`.
 
-Codex currently exposes MCP and global instruction surfaces, but not a standalone user hook add command like Grok. The Codex passive behavior is therefore rule/skill-driven; Grok additionally gets an executable SessionStart hook.
+The installer is idempotent. For Codex it also runs `codex plugin add omo-memory@islee23520 --json` when installing into the real home directory.
 
 ## Session bootstrap
 

package/dist/hookTemplates.js

@@ -82,9 +82,32 @@ 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.6",
+  "description": "Project-local OMO Memory bootstrap hook and MCP server for Grok.",
+  "author": "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.4",
+  "version": "0.1.6",
   "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,27 @@ 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);
     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; run `grok plugin list` or `grok inspect` to verify discovery."],
     };
 }
 function writeText(path, text) {

package/dist/memory.js

@@ -1,7 +1,6 @@
 import Database from "better-sqlite3";
 import { createHash, randomUUID } from "node:crypto";
 import { mkdirSync } from "node:fs";
-import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { execFileSync } from "node:child_process";
 import { redactSecrets, sanitizeGitRemote } from "./privacy.js";
@@ -13,7 +12,7 @@ export class PurgeConfirmationError extends Error {
 }
 const SCHEMA_VERSION = 1;
 export function defaultDbPath() {
-    return process.env["OMO_MEMORY_DB"] ?? join(homedir(), ".omo", "memory", "state.sqlite");
+    return process.env["OMO_MEMORY_DB"] ?? join(resolveProjectContext().repoRoot, ".omo", "memory", "state.sqlite");
 }
 export function memoryPaths() {
     return { dbPath: defaultDbPath() };

package/docs/adapter-integration.md

@@ -1,6 +1,6 @@
 # Adapter Integration
 
-OMO Memory is the shared local work ledger for OMO adapters. It is host-neutral: lazycodex, omo-on-opencode, lfg, and future adapters all write summaries, decisions, QA evidence, task state, and handoffs to the same local SQLite database at `~/.omo/memory/state.sqlite` by default.
+OMO Memory is the shared local work ledger for OMO adapters. It is host-neutral: lazycodex, omo-on-opencode, lfg, and future adapters all write summaries, decisions, QA evidence, task state, and handoffs to the same project-local SQLite database at `<project-root>/.omo/memory/state.sqlite` by default.
 
 No full transcript capture by default. Do not store API keys, tokens, `.env` contents, auth files, raw tool logs, auth headers, cookies, or any other secret-bearing material.
 
@@ -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:
 
@@ -93,11 +93,11 @@ npx -y omo-memory hooks install --host all
 
 Supported `--host` values:
 
-- `codex`: installs `~/.codex/skills/omo-memory/SKILL.md` and an idempotent OMO Memory block in `~/.codex/AGENTS.md`.
-- `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.
+- `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/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.
+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/docs/epic-omo-memory.md

@@ -17,7 +17,7 @@ Codegraph solves code intelligence, not work/session memory. OMO needs a separat
 
 ## Product direction
 
-- Global local DB: `~/.omo/memory/state.sqlite`
+- Project-local DB: `<project-root>/.omo/memory/state.sqlite`
 - Project namespace: derive from git remote + repo root hash, with branch/head metadata
 - Local-first privacy: no cloud sync and no secret storage by default
 - Adapter-neutral schema: `host` and `adapter` are metadata, not separate products
@@ -58,7 +58,7 @@ Codegraph solves code intelligence, not work/session memory. OMO needs a separat
 
 ### CLI
 
-- `omo-memory init` creates or migrates `~/.omo/memory/state.sqlite`.
+- `omo-memory init` creates or migrates `<project-root>/.omo/memory/state.sqlite`.
 - `omo-memory session start --host grok --adapter lfg` records a session for the current project.
 - `omo-memory event record --type decision --summary "..."` appends a project/session event.
 - `omo-memory recent` lists recent project events.

package/package.json

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