omo-memory 0.1.3 → 0.1.5

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,7 +63,7 @@ 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
 
@@ -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.
+- 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.
 
-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

@@ -84,7 +84,7 @@ try {
 export const GROK_HOOK_SCRIPT = SESSION_BOOTSTRAP_SCRIPT.replace('?? "codex"', '?? "grok"').replace('?? "lazycodex"', '?? "lfg"');
 export const CODEX_PLUGIN_JSON = `{
   "name": "omo-memory",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Session-start OMO Memory bootstrap hook for Codex.",
   "author": "islee23520",
   "homepage": "https://github.com/islee23520/omo-memory",

package/dist/hooks.js

@@ -1,3 +1,4 @@
+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";
@@ -40,12 +41,14 @@ function installCodex(home) {
     upsertMarketplace(marketplaceJsonPath, { withInterface: false });
     upsertMarketplace(agentsMarketplaceJsonPath, { withInterface: true });
     upsertCodexConfig(configPath, marketplacePath);
+    const pluginAddNote = maybeInstallCodexPlugin(home);
     return {
         host: "codex",
         files: [skillPath, agentsPath, pluginJsonPath, pluginSkillPath, hookJsonPath, hookScriptPath, marketplaceJsonPath, agentsMarketplaceJsonPath, configPath],
         notes: [
             "Codex MCP still needs `codex mcp add omo-memory -- npx -y omo-memory mcp` if it is not already present.",
             "Codex plugin hooks are installed through the local islee23520 marketplace and enabled in ~/.codex/config.toml.",
+            pluginAddNote,
             "Codex may ask to trust the new hook command on first execution unless hook trust has already been granted.",
         ],
     };
@@ -119,6 +122,19 @@ function upsertCodexConfig(path, marketplacePath) {
     const withMarketplace = ensureTomlTable(withHooks, `[marketplaces.${CODEX_MARKETPLACE}]`, `source_type = "local"\nsource = "${escapeTomlString(marketplacePath)}"`);
     writeText(path, ensureTomlTable(withMarketplace, `[plugins."${CODEX_PLUGIN}@${CODEX_MARKETPLACE}"]`, "enabled = true"));
 }
+function maybeInstallCodexPlugin(home) {
+    if (home !== homedir())
+        return "Skipped `codex plugin add` because OMO_MEMORY_INSTALL_HOME points at a test/alternate home.";
+    const result = spawnSync("codex", ["plugin", "add", `${CODEX_PLUGIN}@${CODEX_MARKETPLACE}`, "--json"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        timeout: 15000,
+    });
+    if (result.status === 0)
+        return "`codex plugin add omo-memory@islee23520 --json` completed successfully.";
+    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 ensureTomlKey(text, table, keyValue) {
     if (text.includes(keyValue))
         return 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.
 
@@ -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`.
+- `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.
 - `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.
 
 ## 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.3",
+  "version": "0.1.5",
   "description": "Host-neutral local SQLite memory and session ledger for OMO adapters, exposed through CLI and MCP.",
   "type": "module",
   "files": [