@nogataka/claw-memory 0.1.1 → 0.1.3

package/.claude-plugin/marketplace.json

@@ -3,14 +3,14 @@
   "owner": { "name": "nogataka" },
   "metadata": {
     "description": "claw-memory: local semantic memory + raw-log search for Claude Code",
-    "version": "0.1.1"
+    "version": "0.1.3"
   },
   "plugins": [
     {
       "name": "claw-memory",
       "source": "./",
       "description": "Local semantic memory: auto-distill, recall injection, and raw Claude Code + Codex transcript search.",
-      "version": "0.1.1"
+      "version": "0.1.3"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claw-memory",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Local semantic memory for Claude Code: auto-distills sessions, injects relevant past context, and searches raw Claude Code + Codex transcripts. sqlite-vec + local embeddings, no daemon, no Python.",
   "author": { "name": "nogataka" },
   "repository": "https://github.com/nogataka/claw-memory",

package/.codex-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "claw-memory",
+  "version": "0.1.2",
+  "description": "Local semantic memory for Codex: auto-distills sessions, injects relevant past context via hooks, and searches raw Codex + Claude Code transcripts. sqlite-vec + local embeddings, no daemon, no Python.",
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "hooks": "./hooks/hooks.codex.json",
+  "interface": {
+    "displayName": "claw-memory",
+    "shortDescription": "Local semantic memory + transcript search for Codex",
+    "longDescription": "Auto-distills finished sessions into a local sqlite-vec store, injects relevant preferences and past-conversation context at session start via hooks, and exposes memory_recall / memory_search / memory_search_logs MCP tools. Runs fully local with Xenova e5 embeddings — no daemon, no Python.",
+    "developerName": "nogataka",
+    "category": "productivity",
+    "capabilities": ["memory", "context", "search"]
+  }
+}

package/README.ja.md

@@ -132,9 +132,27 @@ Claude Code を再起動してください。次が自動登録されます。
 > **プラグインを使わない場合**: `claw-memory install --claude-code` で MCP サーバーと
 > フックを `~/.claude/settings.json` にマージできます（冪等・バックアップ付き）。
 
-### 手順 2b — Codex（インストーラ）
+### 手順 2b — Codex（プラグイン）
 
-Codex には第三者プラグインのマーケットプレイスが無いため、インストーラで登録します。
+Codex は Claude Code と同じプラグイン形式に対応しています。claw-memory は
+`.codex-plugin/plugin.json` を同梱しているため、Codex プラグインとして導入すると
+MCP サーバーと**ライフサイクル hooks の両方**が登録され、Claude Code と同等になります。
+
+```
+codex
+/plugins
+```
+
+プラグインは Codex が互換提供する `${CLAUDE_PLUGIN_ROOT}` を介して次を登録します。
+
+- `claw-memory` MCP サーバー（`.mcp.json`）
+- `SessionStart` / `UserPromptSubmit` → **recall 自動注入**（memory ブロックを developer context として）
+- `Stop` → 最近の Codex セッションの**自動 distill**（watermark 重複回避・非同期）
+- `memory-recall` skill
+
+### 手順 2b（代替）— Codex（インストーラ／マーケット非経由）
+
+マーケットプレイスではなく npm から導入する場合は CLI で登録します。
 
 ```bash
 claw-memory install --codex
@@ -143,11 +161,12 @@ claw-memory install --codex
 これは冪等に次を行います。
 
 - `~/.codex/config.toml` に `[mcp_servers.claw-memory]` を追記（`config.toml.bak` にバックアップ）
+- `~/.codex/hooks.json` に recall/distill hooks をマージ（バックアップあり・既存 hook は保全）
 - `memory-recall` skill を配置
 - `AGENTS.md` に「セッション冒頭で `memory_recall` を呼ぶ」指示を追記
 
-Codex を再起動してください。**Codex 側の自動 distill は手動のみ**（Stop フック相当が無い
-ため）。定期的に自分で実行します。
+Codex を再起動してください。**recall 注入・自動 distill は hooks で自動実行**され、手動操作は不要です。
+必要に応じて手動バックフィルも可能です。
 
 ```bash
 claw-memory distill-codex --recent     # 最近の Codex セッションを蒸留（watermark で重複回避）
@@ -262,6 +281,14 @@ claw-memory uninstall [--codex | --claude-code]
 claw-memory ui --open        # http://localhost:4319
 ```
 
+**Claude Code プラグインだけ**で導入した場合（グローバル npm 未導入）、`claw-memory`
+コマンドは `PATH` に乗りません。その場合は `npx` 経由で起動してください。
+
+```bash
+npx @nogataka/claw-memory ui --open       # http://localhost:4319
+npx @nogataka/claw-memory ui --port 5000 --open
+```
+
 読み取り専用。プロジェクト・要約・会話チャンク（type / concepts / files 付き）・好みを
 閲覧でき、**🔎 ログ検索** で Claude Code + Codex の生ログを全文検索できます。開いている間
 は SSE で自動更新。それ以外はバックグラウンドで何も動きません — 確認したい時だけ起動して
@@ -272,7 +299,7 @@ claw-memory ui --open        # http://localhost:4319
 ## アンインストール
 
 ```bash
-claw-memory uninstall --codex          # config.toml ブロック + skill + AGENTS 記述を除去
+claw-memory uninstall --codex          # config.toml ブロック + hooks + skill + AGENTS 記述を除去
 claw-memory uninstall --claude-code    # settings.json から mcp + フックを除去
 # Claude Code プラグイン: /plugin uninstall claw-memory
 npm uninstall -g @nogataka/claw-memory

package/README.md

@@ -137,9 +137,27 @@ No manual config. To verify, run `/mcp` and look for `claw-memory`.
 > **Not using the plugin?** Run `claw-memory install --claude-code` to merge the MCP
 > server and hooks into `~/.claude/settings.json` (idempotent, backs up the file).
 
-### Step 2b — Codex (installer)
+### Step 2b — Codex (plugin)
 
-Codex has no third-party plugin marketplace, so register via the installer:
+Codex supports the same plugin format as Claude Code. claw-memory ships a
+`.codex-plugin/plugin.json` manifest, so installing it as a Codex plugin wires up
+the MCP server **and** the lifecycle hooks — full parity with Claude Code:
+
+```
+codex
+/plugins
+```
+
+The plugin registers, via Codex's `${CLAUDE_PLUGIN_ROOT}` (provided for compatibility):
+
+- the `claw-memory` MCP server (`.mcp.json`),
+- `SessionStart` / `UserPromptSubmit` → **auto recall injection** (memory block as developer context),
+- `Stop` → **auto distill** of recent Codex sessions (watermark-deduped, async), and
+- the `memory-recall` skill.
+
+### Step 2b (alt) — Codex (installer, no marketplace)
+
+If you install from npm instead of the plugin marketplace, register via the CLI:
 
 ```bash
 claw-memory install --codex
@@ -148,11 +166,12 @@ claw-memory install --codex
 This idempotently:
 
 - adds `[mcp_servers.claw-memory]` to `~/.codex/config.toml` (backed up to `config.toml.bak`),
+- merges recall/distill hooks into `~/.codex/hooks.json` (backed up; your own hooks are preserved),
 - installs the `memory-recall` skill, and
 - appends an `AGENTS.md` instruction telling the agent to call `memory_recall` at session start.
 
-Restart Codex. **Auto-distill is manual on Codex** (no equivalent of the Stop hook) — run
-it yourself periodically:
+Restart Codex. **Recall injection and auto-distill now run via hooks** — no manual step needed.
+You can still backfill on demand:
 
 ```bash
 claw-memory distill-codex --recent     # distill recent Codex sessions (watermark-deduped)
@@ -267,6 +286,14 @@ session ends (Stop hook / distill-codex)   session starts (SessionStart hook / m
 claw-memory ui --open        # http://localhost:4319
 ```
 
+If you installed via the **Claude Code plugin only** (no global npm install), the
+`claw-memory` binary isn't on your `PATH`. Run the viewer through `npx` instead:
+
+```bash
+npx @nogataka/claw-memory ui --open       # http://localhost:4319
+npx @nogataka/claw-memory ui --port 5000 --open
+```
+
 Read-only. Browse projects, session summaries, conversation chunks (with type /
 concepts / files), and preferences; toggle **🔎 ログ検索** to full-text search raw
 Claude Code + Codex transcripts. Live-updates via SSE while open. Nothing runs in the
@@ -277,7 +304,7 @@ background otherwise — start it only when you want to inspect.
 ## Uninstall
 
 ```bash
-claw-memory uninstall --codex          # remove config.toml block + skill + AGENTS note
+claw-memory uninstall --codex          # remove config.toml block + hooks + skill + AGENTS note
 claw-memory uninstall --claude-code    # remove mcp + hooks from settings.json
 # Claude Code plugin: /plugin uninstall claw-memory
 npm uninstall -g @nogataka/claw-memory

package/dist/cli.js

@@ -88,7 +88,7 @@ async function main() {
             if (target === "codex") {
                 const { installCodex } = await import("./core/installer/codex.js");
                 console.log("claw-memory installed for Codex:\n  " + installCodex().join("\n  "));
-                console.log("\n注意: Codex を再起動してください。自動 distill は手動 (`claw-memory distill-codex --recent`)。");
+                console.log("\n注意: Codex を再起動してください。recall 注入・自動 distill は hooks で自動実行されます。");
             }
             else {
                 const { installClaude } = await import("./core/installer/claude.js");

package/dist/core/installer/codex.js

@@ -13,7 +13,17 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, rmSyn
 const CODEX_DIR = join(homedir(), ".codex");
 const CONFIG = join(CODEX_DIR, "config.toml");
 const AGENTS = join(CODEX_DIR, "AGENTS.md");
+const HOOKS = join(CODEX_DIR, "hooks.json");
 const SKILL_DIR = join(CODEX_DIR, "skills", "memory-recall");
+// Codex lifecycle hooks for the manual (non-plugin) install path. Mirrors the
+// Claude Code hook wiring: recall on session start / prompt, distill on stop.
+// Codex Stop carries no Claude-format transcript, so distill scans recent Codex
+// session files (watermark-guarded) instead of a single transcript_path.
+const HOOK_EVENTS = [
+    ["SessionStart", "hook recall", false],
+    ["UserPromptSubmit", "hook recall", false],
+    ["Stop", "distill-codex --limit 5", true],
+];
 const BEGIN = "# >>> claw-memory >>>";
 const END = "# <<< claw-memory <<<";
 const A_BEGIN = "<!-- >>> claw-memory >>> -->";
@@ -24,18 +34,73 @@ function tomlStr(s) {
 }
 /** Prefer a globally installed `claw-memory`; otherwise run via npx. */
 function resolveCommand() {
+    const bin = resolveBin();
+    return bin
+        ? { command: bin, args: ["mcp"] }
+        : { command: "npx", args: ["-y", "@nogataka/claw-memory@latest", "mcp"] };
+}
+/** Absolute path to a globally installed `claw-memory`, or null. */
+function resolveBin() {
     try {
         const found = execFileSync("command", ["-v", "claw-memory"], {
             shell: "/bin/bash",
             encoding: "utf-8",
-        }).trim();
-        if (found)
-            return { command: found.split("\n")[0], args: ["mcp"] };
+        }).trim().split("\n")[0];
+        return found || null;
+    }
+    catch {
+        return null;
+    }
+}
+/** How to invoke the CLI from a hook command line. */
+function cliInvoker() {
+    return resolveBin() ?? "npx -y @nogataka/claw-memory@latest";
+}
+function readHooks() {
+    if (!existsSync(HOOKS))
+        return {};
+    try {
+        return JSON.parse(readFileSync(HOOKS, "utf-8"));
     }
     catch {
-        // not on PATH
+        return {};
     }
-    return { command: "npx", args: ["-y", "@nogataka/claw-memory@latest", "mcp"] };
+}
+/** A hook command is ours if it runs the claw-memory CLI recall/distill subcommand. */
+function isOurHook(cmd) {
+    return cmd.includes("claw-memory") && (cmd.includes("hook recall") || cmd.includes("distill-codex"));
+}
+/** Merge our recall/distill hooks into ~/.codex/hooks.json, replacing stale ones. */
+function installHooks() {
+    const cli = cliInvoker();
+    const f = readHooks();
+    f.hooks = f.hooks ?? {};
+    for (const [event, sub, isAsync] of HOOK_EVENTS) {
+        const list = (f.hooks[event] ?? []).filter((g) => !g.hooks?.some((h) => isOurHook(h.command)));
+        list.push({ hooks: [{ type: "command", command: `${cli} ${sub}`, async: isAsync }] });
+        f.hooks[event] = list;
+    }
+    if (existsSync(HOOKS))
+        copyFileSync(HOOKS, HOOKS + ".bak");
+    writeFileSync(HOOKS, JSON.stringify(f, null, 2) + "\n");
+}
+/** Remove our hooks from ~/.codex/hooks.json, preserving the user's own. */
+function removeHooks() {
+    if (!existsSync(HOOKS))
+        return false;
+    const f = readHooks();
+    if (!f.hooks)
+        return false;
+    for (const event of Object.keys(f.hooks)) {
+        f.hooks[event] = f.hooks[event]
+            .map((g) => ({ ...g, hooks: (g.hooks ?? []).filter((h) => !isOurHook(h.command)) }))
+            .filter((g) => g.hooks.length > 0);
+        if (f.hooks[event].length === 0)
+            delete f.hooks[event];
+    }
+    copyFileSync(HOOKS, HOOKS + ".bak");
+    writeFileSync(HOOKS, JSON.stringify(f, null, 2) + "\n");
+    return true;
 }
 /** Insert or replace the marker-delimited block in `content`. */
 function upsertBlock(content, begin, end, block) {
@@ -98,6 +163,9 @@ export function installCodex() {
     const agentsPrev = existsSync(AGENTS) ? readFileSync(AGENTS, "utf-8") : "";
     writeFileSync(AGENTS, upsertBlock(agentsPrev, A_BEGIN, A_END, agentsBlock));
     done.push("AGENTS.md: recall instruction");
+    // 4) lifecycle hooks: auto recall (SessionStart/UserPromptSubmit) + auto distill (Stop)
+    installHooks();
+    done.push("hooks.json: SessionStart/UserPromptSubmit→recall, Stop→distill-codex");
     return done;
 }
 export function uninstallCodex() {
@@ -111,6 +179,9 @@ export function uninstallCodex() {
         writeFileSync(AGENTS, removeBlock(readFileSync(AGENTS, "utf-8"), A_BEGIN, A_END));
         done.push("AGENTS.md: removed claw-memory block");
     }
+    if (removeHooks()) {
+        done.push("hooks.json: removed claw-memory hooks");
+    }
     try {
         rmSync(SKILL_DIR, { recursive: true, force: true });
         done.push("skill: removed");

package/dist/core/llm.js

@@ -63,6 +63,11 @@ async function completeAgentSdk(prompt, model) {
             maxTurns: 1,
             allowedTools: [],
             permissionMode: "bypassPermissions",
+            // SDK isolation: do NOT load ~/.claude or project settings into the
+            // distillation sub-session. Otherwise the user's own hooks (e.g. a Stop
+            // hook that plays a sound) and claw-memory's own hooks fire on every
+            // spawned sub-session — a beep storm and needless recursion.
+            settingSources: [],
             env: buildFullSdkEnv(),
         },
     });

package/hooks/hooks.codex.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh hook recall",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh hook recall",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh distill-codex --limit 5",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" claw-hook.sh hook recall",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh hook recall",
             "async": false
           }
         ]
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" claw-hook.sh hook recall",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh hook recall",
             "async": false
           }
         ]
@@ -27,7 +27,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" claw-hook.sh hook distill",
+            "command": "\"$CLAUDE_PLUGIN_ROOT/hooks/run-hook.cmd\" claw-hook.sh hook distill",
             "async": true
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nogataka/claw-memory",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Independent, in-process semantic memory MCP server (sqlite-vec + local Xenova e5) with a lightweight web viewer. No daemon, no Python. Installable as a Claude Code plugin and a Codex MCP server.",
   "license": "MIT",
@@ -26,6 +26,7 @@
     "hooks",
     "skills",
     ".claude-plugin",
+    ".codex-plugin",
     ".mcp.json",
     "README.md",
     "README.ja.md"