@memfork/cli 0.1.42 → 0.1.44

package/dist/commands/install.js

@@ -15,6 +15,7 @@
  *   codex    — ~/.codex/config.toml  +  installs plugin into this project
  */
 import chalk from "chalk";
+import { execSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -122,17 +123,49 @@ function installCodex(cwd) {
     else {
         console.log(warn("MemWal MCP skipped — run `memfork init` first to provision credentials."));
     }
-    // ── 2. Codex plugin (skills + metadata) ──────────────────────────────────
+    // ── 2. Codex plugin — build marketplace layout + register + install ───────
+    //
+    // Codex uses a marketplace model. We copy the plugin source into
+    // ~/.memfork/codex-plugin/ (a global location so it works from any project),
+    // register it as a local marketplace, then install memforks@memforks.
+    // The user runs nothing extra.
+    const marketplaceDst = path.join(os.homedir(), ".memfork", "codex-plugin");
     const pluginSrc = path.join(PLUGIN_ROOT, "codex");
-    const pluginDst = path.join(cwd, ".codex-plugin");
-    copyDir(pluginSrc, pluginDst);
-    console.log(ok("Plugin: .codex-plugin/  (skills + plugin.json)"));
+    copyDir(pluginSrc, marketplaceDst);
+    console.log(ok(`Plugin files: ${dim(marketplaceDst)}`));
+    // Register marketplace (idempotent — Codex no-ops if already added).
+    try {
+        execSync(`codex plugin marketplace add ${JSON.stringify(marketplaceDst)} --json`, {
+            stdio: "pipe",
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        // Codex exits non-zero when the marketplace is already registered.
+        if (!msg.includes("already")) {
+            console.log(warn(`Marketplace registration failed: ${msg}`));
+            console.log(dim(`    Run manually: codex plugin marketplace add ~/.memfork/codex-plugin`));
+        }
+    }
+    // Install / upgrade the plugin (idempotent).
+    try {
+        execSync(`codex plugin add memforks@memforks --json`, { stdio: "pipe" });
+        console.log(ok("Plugin:     memforks@memforks  (installed)"));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        // Already installed at the same version is not a real error.
+        if (msg.includes("already")) {
+            console.log(ok("Plugin:     memforks@memforks  (up to date)"));
+        }
+        else {
+            console.log(warn(`Plugin install failed: ${msg}`));
+            console.log(dim(`    Run manually: codex plugin add memforks@memforks`));
+        }
+    }
     // ── Summary ────────────────────────────────────────────────────────────────
     console.log("");
-    console.log(chalk.bold("Done."));
-    console.log("");
-    console.log(tip("Register the plugin in Codex:"));
-    console.log(dim("    codex plugin add .codex-plugin"));
+    console.log(chalk.bold("Done.") + " Restart Codex to pick up the plugin and MCP server.");
     console.log("");
     console.log(tip("The agent now has:"));
     console.log(dim("    memwal_recall / memwal_remember  — memory storage via MemWal MCP"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memfork/cli",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "MemForks CLI — init, commit, recall, merge, install plugins",
   "repository": {
     "type": "git",

package/plugins/codex/.agents/plugins/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "memforks",
+  "interface": { "displayName": "MemForks" },
+  "plugins": [
+    {
+      "name": "memforks",
+      "source": { "source": "local", "path": "./plugins/memforks" },
+      "policy": { "installation": "AVAILABLE", "authentication": "ON_USE" },
+      "category": "Productivity"
+    }
+  ]
+}

package/plugins/codex/plugins/memforks/skills/memory-commit/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: memory-commit
+description: >-
+  Commit facts to the MemForks memory DAG using memfork commit --facts.
+  Use whenever the user says "remember that", "commit this", "save that",
+  "note that", "don't forget", or any phrasing that asks you to persist
+  a decision, convention, or finding for future sessions.
+---
+
+# Memory Commit
+
+When the user asks you to remember something — a decision, a convention, a
+finding — **always use `memfork commit --facts`**, not `memwal_remember`.
+
+`memfork commit --facts` does two things in one command:
+
+1. Indexes the facts in MemWal for semantic recall (same as `memwal_remember`)
+2. Anchors them on-chain on Sui, tagged to the current Git branch
+
+`memwal_remember` alone does only step 1. It saves to `namespace=default`
+with no branch scoping and no on-chain anchor. Use it only for transient,
+throwaway notes that don't warrant a permanent record.
+
+## Procedure
+
+### 1. Identify the facts
+
+Extract 1–3 concrete, standalone facts from what the user said. Facts should
+be self-contained sentences — readable out of context in a future session.
+
+Good:
+```
+"error handling convention: always wrap in AppError, never throw raw"
+"auth latency target: p99 < 200ms on bcrypt verify"
+```
+
+Bad (too vague, depends on context):
+```
+"we agreed on this"
+"the thing we discussed"
+```
+
+### 2. Run the commit
+
+```bash
+memfork commit \
+  --message "<one-line summary of the decision>" \
+  --facts "<fact 1>" "<fact 2>"
+```
+
+The CLI auto-detects the current Git branch — do **not** pass `--branch`
+unless explicitly targeting a different branch.
+
+### 3. Confirm to the user
+
+After the commit succeeds, print a confirmation in this form:
+
+```
+[memforks] Committed to <branch> — "<message>"
+```
+
+Do not print the full CLI output. One line is enough.
+
+## Rules
+
+- Never use `memwal_remember` for facts the user explicitly asks to save.
+- Never commit task state, in-progress work, or temporary findings.
+- If `memfork commit` fails (e.g. no tree initialised), tell the user to
+  run `memfork init` first and offer to retry.
+- One commit per logical decision — don't batch unrelated facts together.