open-memex 0.6.0-alpha.5 → 0.6.0-alpha.8

package/AGENTS.md

@@ -75,9 +75,15 @@ TTY (usage as before when non-interactive); init/uninstall maintain a
 `.init.json` first-run marker at the data root so the offer is asked once (D50);
 init ends with a one-line next-step hint (`open-memex add` + ask the agent to
 recall it) so a first-time user sees what "it works" looks like (D51).
+init also installs the bundled `open-memex` Agent Skill (skills/open-memex/SKILL.md,
+teaches skill-aware agents the CLI: save/search/scope rules/outbox flow) into each
+wired editor's user-level skills dir — ~/.copilot/skills/ (VS Code),
+~/.cursor/skills/ (Cursor), ~/.config/opencode/skills/ (opencode); Visual Studio
+has no skills concept and is skipped. Copy, not symlink (Windows needs no
+Developer Mode); existing skill kept unless --force (D54).
 `open-memex uninstall [--client vscode|cursor|opencode|visualstudio] [--global] [--yes]`
 reverses init — removes the MCP server entry / opencode plugin line / Copilot
-instructions section; memory data never touched (D48); no --client → auto-detect
+instructions section / Agent Skill directory; memory data never touched (D48); no --client → auto-detect
 with an interactive confirm, explicit --client never prompts; `--yes` only skips
 that confirm; `--global` limits cleanup to user-level. Empty/whitespace-only
 config files parse as `{}` and are safely populated (D49); non-JSON (JSONC)

package/README.md

@@ -113,6 +113,12 @@ This installs the `0.5.1` stable release.
 npm install -g open-memex@alpha
 ```
 
+```sh
+open-memex init
+```
+
+The install isn't complete until you run `open-memex init` — it wires up your editors (VS Code, Cursor, opencode, and Visual Studio for solution projects).
+
 See what's published:
 
 ```sh
@@ -180,7 +186,9 @@ npx -y open-memex init --yes
 With no `--client`, `init` **detects your installed editors and wires them all**
 — user-level where the editor supports it (VS Code / Cursor MCP config, opencode
 native plugin), so one init covers every project. Visual Studio joins in when the
-project has a solution file. Prefer to pick a single editor? Pass `--client`:
+project has a solution file. It also installs an **Agent Skill** (`open-memex`)
+into each editor's skills folder, so skill-aware agents can use your memory via
+the CLI with no MCP configuration. Prefer to pick a single editor? Pass `--client`:
 
 > **Two different "globals" — don't mix them up.**
 > - `npm install -g open-memex` installs the *package* globally: it puts the

package/README.zh-CN.md

@@ -108,6 +108,12 @@ npm install -g open-memex
 npm install -g open-memex@alpha
 ```
 
+```sh
+open-memex init
+```
+
+不跑 `open-memex init` 把编辑器接上，安装就不算完成（支持 VS Code、Cursor、opencode，有 .sln 的项目还支持 Visual Studio）。
+
 查看已发布版本：
 
 ```sh
@@ -173,6 +179,8 @@ npx -y open-memex init --yes
 不带 `--client` 时，`init` 会**自动检测本机装了哪些编辑器，一次全接上**——
 支持用户级的编辑器走用户级（VS Code / Cursor 的 MCP 配置、opencode 原生插件），
 一次 init，所有项目通用；项目里有 solution 文件时 Visual Studio 也会一起配。
+同时会给每个编辑器装一个 **Agent Skill**（`open-memex`），懂 skill 的 agent
+不用配 MCP 也能通过 CLI 用你的记忆。
 想只配某一个编辑器？加 `--client`：
 
 > **两个"全局"不是一回事，别搞混。**

package/dist/cli.js

@@ -516,30 +516,31 @@ async function main() {
             usage(0);
         return;
     }
-    if (cmd === "--help" || cmd === "-h" || cmd === "help")
-        usage(0);
-    if (cmd === "--version" || cmd === "-v") {
-        // package.json sits two levels above this file in both layouts
-        // (src/cli.ts and dist/cli.js).
-        const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-        const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
-        console.log(`open-memex ${pkg.version}`);
-        return;
-    }
     // F28: npm runs lifecycle scripts in the background and swallows their
     // stdout (unless --foreground-scripts), so the D50 postinstall pointer
     // never reaches the user. Every CLI entry point therefore carries a
     // one-line nudge on stderr until init has run or been declined — stderr
     // keeps the MCP stdio protocol (stdout) intact, and the .init.json marker
     // makes it once-ever. `init`/`uninstall` are excluded (already there /
-    // nothing to wire).
+    // nothing to wire). Placed before the --help/--version early returns:
+    // `-v` is the first thing people run after installing.
     if (cmd !== "init" && cmd !== "uninstall") {
         const { isFirstRun } = await import("./first-run.js");
         if (isFirstRun()) {
             console.error("open-memex: first run? `open-memex init` wires it into your editors " +
-                "(auto-detects VS Code, Cursor, opencode).");
+                "(auto-detects VS Code, Cursor, opencode — and Visual Studio for solution projects).");
         }
     }
+    if (cmd === "--help" || cmd === "-h" || cmd === "help")
+        usage(0);
+    if (cmd === "--version" || cmd === "-v") {
+        // package.json sits two levels above this file in both layouts
+        // (src/cli.ts and dist/cli.js).
+        const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+        console.log(`open-memex ${pkg.version}`);
+        return;
+    }
     // Per-command help: `open-memex <command> --help`. Checked before loadConfig()
     // so it works even when the environment is broken.
     if (rest.includes("--help") || rest.includes("-h")) {

package/dist/first-run.js

@@ -64,7 +64,7 @@ export async function offerFirstRunInit(runInit) {
     if (!shouldOfferFirstRun())
         return "skipped";
     console.log(`It looks like open-memex hasn't been set up on this machine yet.\n` +
-        "`open-memex init` wires it into your editors (auto-detects VS Code, Cursor and opencode).\n");
+        "`open-memex init` wires it into your editors (auto-detects VS Code, Cursor and opencode — and Visual Studio for solution projects).\n");
     if (await askYesNo("Run it now? [Y/n] ")) {
         await runInit();
         return "initialized";

package/dist/init.js

@@ -497,6 +497,62 @@ async function promptConfigLevel() {
         rl.close();
     }
 }
+// ---------------------------------------------------------------------------
+// D54: Agent Skills. The bundled open-memex skill (skills/open-memex/SKILL.md)
+// teaches skill-aware agents to use open-memex via the CLI. init copies it
+// (not symlinks — Windows needs no Developer Mode) into each wired editor's
+// user-level skills dir; uninstall removes only our directory.
+// ---------------------------------------------------------------------------
+/** Package root, two levels above this module (src/init.ts or dist/init.js). */
+export function packageRoot() {
+    return path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+}
+/** Where the bundled skill lives inside the installed package. */
+export function skillSourceDir(pkgRoot = packageRoot()) {
+    return path.join(pkgRoot, "skills", "open-memex");
+}
+/**
+ * D54: user-level Agent Skills directory for the open-memex skill, per client.
+ * null = the client has no skills concept (Visual Studio).
+ */
+export function skillTargetDir(client, env = {}) {
+    const home = env.home ?? os.homedir();
+    switch (client) {
+        case "vscode":
+            return path.join(home, ".copilot", "skills", "open-memex");
+        case "cursor":
+            return path.join(home, ".cursor", "skills", "open-memex");
+        case "opencode":
+            return path.join(opencodeConfigDir(home, env.xdgConfigHome ?? process.env.XDG_CONFIG_HOME), "skills", "open-memex");
+        case "visualstudio":
+            return null;
+    }
+}
+/**
+ * Install the bundled skill for one client. Skips when already present unless
+ * force (a customized skill is never clobbered silently).
+ */
+export function writeSkill(client, opts = {}) {
+    const target = skillTargetDir(client, opts);
+    if (!target)
+        return "unsupported";
+    const source = skillSourceDir(opts.pkgRoot ?? packageRoot());
+    if (!exists(path.join(source, "SKILL.md")))
+        return "missing-source";
+    if (exists(target) && !opts.force)
+        return "skipped";
+    fs.rmSync(target, { recursive: true, force: true });
+    fs.cpSync(source, target, { recursive: true });
+    return "installed";
+}
+/** Remove the open-memex skill installed by init for one client. */
+export function removeSkill(client, env = {}) {
+    const target = skillTargetDir(client, env);
+    if (!target || !exists(target))
+        return "absent";
+    fs.rmSync(target, { recursive: true, force: true });
+    return "removed";
+}
 function exists(p) {
     try {
         return fs.existsSync(p);
@@ -661,6 +717,12 @@ export async function initProject(opts) {
                 writeMcpJson(root, client, opts.force);
             }
         }
+        // D54: Agent Skills — user-level by design (init once), alongside the MCP wiring.
+        const skill = writeSkill(client, { force: opts.force });
+        if (skill === "installed")
+            console.log(`  + Agent Skill installed (${skillTargetDir(client)})`);
+        else if (skill === "skipped")
+            console.log(`  - Agent Skill already present for ${client} (use --force to refresh)`);
     }
     if (clients.length === 0) {
         console.log("  - editor setup skipped");
@@ -855,6 +917,8 @@ export async function uninstallProject(opts) {
             // Solution-level only — --global is meaningless, same as init.
             bump(removeServerEntryFile(path.join(root, ".mcp.json"), "servers"));
         }
+        // D54: remove the Agent Skill installed by init.
+        bump(removeSkill(client));
     }
     // Copilot instructions: init may have written personal (default) or project.
     if (clients.some((c) => c !== "opencode")) {

package/dist/tools/ops.js

@@ -40,7 +40,7 @@ export const TOOL_DESCRIPTIONS = {
     memory_list: "List memories in a scope, newest first. Useful for browsing what is remembered, or verifying that a save landed.",
     memory_supersede: "Replace an existing memory with a newer version. The old memory is kept as history (status: superseded) and retrieval returns the new one. Use when a saved fact becomes outdated and should be replaced rather than duplicated.",
     memory_forget: "Delete a memory by id. Use when the user asks to forget something.",
-    memory_status: "Show the project memory sync pipeline: drafts waiting in the outbox (appdata), memories in the repo awaiting review or published, and any repo files not yet committed. Call this at session start and at task checkpoints, then ask the user which drafts to sync. The user may also trigger this flow by saying 'sync memory' (or '同步记忆').",
+    memory_status: "Show the project memory sync pipeline: drafts waiting in the outbox (appdata), memories in the repo awaiting review or published, and any repo files not yet committed. Call this at session start, when the server reports drafts waiting for review, or when the user says 'sync memory' (or '同步记忆'); then ask the user which drafts to sync.",
     memory_submit: "Move outbox drafts into the repo memory dir for review: copies the drafts in as proposed (or keeps a local approval), commits locally on the current branch, and moves the outbox originals out. Never creates a branch on its own — pass branch= only with the user's explicit approval for the full chain. Prints the push and PR commands — those need the user's explicit approval and are never run automatically.",
     memory_propose: "Copy personal memories into the project outbox as review drafts. The personal originals stay put.",
     memory_promote: "Advance a project memory one step up the review ladder (proposed → approved → published), or reject it with a note. Rejected memories are never deleted — they can be revised and resubmitted.",
@@ -63,7 +63,7 @@ export const memoryAddArgs = {
     source: z
         .string()
         .optional()
-        .describe("Where this memory came from. Default: tool. Pass 'inference' for agent-proposed captures at checkpoints (V2-DESIGN §3.5)."),
+        .describe("Where this memory came from. Default: tool. Pass 'inference' for agent-proposed captures (V2-DESIGN §3.5)."),
 };
 export const memorySearchArgs = {
     query: z

package/docs/V2-DESIGN.md

@@ -1073,6 +1073,36 @@ requirement: personal data never touches third-party services). Benchmarks to tr
   channel the project controls — the CLI — not in npm script output.
   Reported 2026-10-01.*
 
+- **F29** — Copilot review fixes on PR #11 (0.6.0-alpha.7). (a) The lockfile
+  carried a stray `"version": "0.6.0-alpha.1"` key as a direct child of
+  `packages` (left by the D50 version bump; hand-edited bumps preserved it) —
+  `npm ls --package-lock-only` failed on it. Removed; version bumps now go
+  through `npm pkg set` so npm owns the lockfile format. (b) D53 missed the
+  shared `TOOL_DESCRIPTIONS.memory_status`: it still told agents to call the
+  tool "at session start and at task checkpoints" — the polling this change
+  retires. Now: session start, server-reported drafts, or explicit "sync
+  memory". Same staleness removed from the `source` field hint. (c) Onboarding
+  strings (postinstall note, first-run nudge, bare-CLI offer) now mention
+  Visual Studio auto-detection for solution projects instead of listing only
+  three editors. *Lesson: never hand-edit version fields in package-lock.json.
+  Reported 2026-10-01.*
+
+- **D54** — Agent Skills support (0.6.0-alpha.8). Ship a bundled
+  `open-memex` skill (`skills/open-memex/SKILL.md`: frontmatter + CLI guide —
+  proactive save, search, scope routing, outbox→submit flow) inside the npm
+  package. `init` copies it (not symlinks — Windows needs no Developer Mode)
+  into each wired editor's user-level skills dir: VS Code →
+  `~/.copilot/skills/open-memex/`, Cursor → `~/.cursor/skills/open-memex/`,
+  opencode → `~/.config/opencode/skills/open-memex/`; Visual Studio has no
+  skills concept and is skipped. User-level by design (D46: init once). An
+  existing skill is never clobbered silently — kept unless `--force`.
+  `uninstall` removes only the `open-memex` skill directory. The skill tells
+  agents to prefer MCP tools (`memory_add` etc.) when available and fall back
+  to the CLI otherwise (with the `npx -y open-memex@latest` prefix when the
+  CLI isn't on PATH). *Rationale: skill-aware agents get memory with zero MCP
+  configuration; the skill is the CLI-shaped complement to the MCP server.
+  Requested by Stone 2026-10-01 after the Agent Skills ecosystem suggestion.*
+
 ## Open Questions
 
 _All resolved — see D10 (rename), D11 (type/role split), D12 (explicit pull)._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-memex",
-  "version": "0.6.0-alpha.5",
+  "version": "0.6.0-alpha.8",
   "description": "Local-first memory layer and protocol for AI coding agents. Markdown source of truth, SQLite FTS5 index, zero cloud.",
   "type": "module",
   "license": "Apache-2.0",

package/scripts/postinstall.js

@@ -5,5 +5,5 @@
 // prints the pointer. Plain JS, no dependencies.
 console.log(
   "\nopen-memex installed. Run `open-memex init` to wire it into your editors — " +
-    "it auto-detects VS Code, Cursor and opencode.\n",
+    "it auto-detects VS Code, Cursor and opencode (and Visual Studio for solution projects).\n",
 );

package/skills/open-memex/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: open-memex
+description: Persistent local-first memory for the user and their projects. Use when the user shares facts, preferences, or decisions worth remembering across sessions, or when you need to recall past context before answering.
+---
+
+# open-memex — local memory
+
+open-memex gives you persistent memory across sessions. Memories live in local
+markdown files (SQLite FTS index); the `personal` scope never leaves this machine.
+
+If `open-memex` MCP tools (`memory_add`, `memory_search`, …) are available in
+this session, prefer them. Otherwise use the CLI below. If `open-memex` is not
+on PATH, prefix commands with `npx -y open-memex@latest`.
+
+## Save — be proactive
+
+When the user shares something worth remembering — a fact, preference,
+decision, convention, or error fix — save it without being asked:
+
+```sh
+open-memex add "standup is at 9:30"                        # current project scope
+open-memex add "I prefer concise diffs" --scope personal   # applies everywhere
+```
+
+Keep each memory one self-contained statement. Scope routing: facts about the
+user ("I"/"me") → `personal`; everything else → the current project.
+
+## Recall
+
+```sh
+open-memex search "deployment steps"   # keyword search across scopes
+open-memex list                       # recent memories in the current project
+```
+
+Search before asking the user about past decisions or preferences they may
+have told you before.
+
+## Project outbox → repo (the sync flow)
+
+New project memories land in a local outbox (not in git). Review and publish:
+
+```sh
+open-memex sync-status     # drafts waiting, repo review state, uncommitted files
+open-memex submit <id>     # publish drafts to .ai/open-memex/ + local commit
+```
+
+If any command output reports drafts waiting in the project outbox, run
+`open-memex sync-status` and ask the user which drafts to sync. The user may
+also trigger this flow by saying "sync memory".
+
+Run `open-memex <command> --help` for full usage of any command.

package/src/cli.ts

@@ -577,16 +577,6 @@ async function main() {
     if (outcome !== "initialized") usage(0);
     return;
   }
-  if (cmd === "--help" || cmd === "-h" || cmd === "help") usage(0);
-
-  if (cmd === "--version" || cmd === "-v") {
-    // package.json sits two levels above this file in both layouts
-    // (src/cli.ts and dist/cli.js).
-    const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
-    console.log(`open-memex ${pkg.version}`);
-    return;
-  }
 
   // F28: npm runs lifecycle scripts in the background and swallows their
   // stdout (unless --foreground-scripts), so the D50 postinstall pointer
@@ -594,17 +584,29 @@ async function main() {
   // one-line nudge on stderr until init has run or been declined — stderr
   // keeps the MCP stdio protocol (stdout) intact, and the .init.json marker
   // makes it once-ever. `init`/`uninstall` are excluded (already there /
-  // nothing to wire).
+  // nothing to wire). Placed before the --help/--version early returns:
+  // `-v` is the first thing people run after installing.
   if (cmd !== "init" && cmd !== "uninstall") {
     const { isFirstRun } = await import("./first-run.ts");
     if (isFirstRun()) {
       console.error(
         "open-memex: first run? `open-memex init` wires it into your editors " +
-          "(auto-detects VS Code, Cursor, opencode).",
+          "(auto-detects VS Code, Cursor, opencode — and Visual Studio for solution projects).",
       );
     }
   }
 
+  if (cmd === "--help" || cmd === "-h" || cmd === "help") usage(0);
+
+  if (cmd === "--version" || cmd === "-v") {
+    // package.json sits two levels above this file in both layouts
+    // (src/cli.ts and dist/cli.js).
+    const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+    console.log(`open-memex ${pkg.version}`);
+    return;
+  }
+
   // Per-command help: `open-memex <command> --help`. Checked before loadConfig()
   // so it works even when the environment is broken.
   if (rest.includes("--help") || rest.includes("-h")) {

package/src/first-run.ts

@@ -84,7 +84,7 @@ export async function offerFirstRunInit(
   if (!shouldOfferFirstRun()) return "skipped";
   console.log(
     `It looks like open-memex hasn't been set up on this machine yet.\n` +
-      "`open-memex init` wires it into your editors (auto-detects VS Code, Cursor and opencode).\n",
+      "`open-memex init` wires it into your editors (auto-detects VS Code, Cursor and opencode — and Visual Studio for solution projects).\n",
   );
   if (await askYesNo("Run it now? [Y/n] ")) {
     await runInit();

package/src/init.ts

@@ -553,6 +553,77 @@ export interface DetectEnv {
   xdgConfigHome?: string;
 }
 
+// ---------------------------------------------------------------------------
+// D54: Agent Skills. The bundled open-memex skill (skills/open-memex/SKILL.md)
+// teaches skill-aware agents to use open-memex via the CLI. init copies it
+// (not symlinks — Windows needs no Developer Mode) into each wired editor's
+// user-level skills dir; uninstall removes only our directory.
+// ---------------------------------------------------------------------------
+
+/** Package root, two levels above this module (src/init.ts or dist/init.js). */
+export function packageRoot(): string {
+  return path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+}
+
+/** Where the bundled skill lives inside the installed package. */
+export function skillSourceDir(pkgRoot: string = packageRoot()): string {
+  return path.join(pkgRoot, "skills", "open-memex");
+}
+
+/**
+ * D54: user-level Agent Skills directory for the open-memex skill, per client.
+ * null = the client has no skills concept (Visual Studio).
+ */
+export function skillTargetDir(
+  client: InitClient,
+  env: DetectEnv = {},
+): string | null {
+  const home = env.home ?? os.homedir();
+  switch (client) {
+    case "vscode":
+      return path.join(home, ".copilot", "skills", "open-memex");
+    case "cursor":
+      return path.join(home, ".cursor", "skills", "open-memex");
+    case "opencode":
+      return path.join(
+        opencodeConfigDir(home, env.xdgConfigHome ?? process.env.XDG_CONFIG_HOME),
+        "skills",
+        "open-memex",
+      );
+    case "visualstudio":
+      return null;
+  }
+}
+
+/**
+ * Install the bundled skill for one client. Skips when already present unless
+ * force (a customized skill is never clobbered silently).
+ */
+export function writeSkill(
+  client: InitClient,
+  opts: { force?: boolean; pkgRoot?: string } & DetectEnv = {},
+): "installed" | "skipped" | "unsupported" | "missing-source" {
+  const target = skillTargetDir(client, opts);
+  if (!target) return "unsupported";
+  const source = skillSourceDir(opts.pkgRoot ?? packageRoot());
+  if (!exists(path.join(source, "SKILL.md"))) return "missing-source";
+  if (exists(target) && !opts.force) return "skipped";
+  fs.rmSync(target, { recursive: true, force: true });
+  fs.cpSync(source, target, { recursive: true });
+  return "installed";
+}
+
+/** Remove the open-memex skill installed by init for one client. */
+export function removeSkill(
+  client: InitClient,
+  env: DetectEnv = {},
+): "removed" | "absent" {
+  const target = skillTargetDir(client, env);
+  if (!target || !exists(target)) return "absent";
+  fs.rmSync(target, { recursive: true, force: true });
+  return "removed";
+}
+
 function exists(p: string): boolean {
   try {
     return fs.existsSync(p);
@@ -726,6 +797,11 @@ export async function initProject(opts: {
         writeMcpJson(root, client, opts.force);
       }
     }
+    // D54: Agent Skills — user-level by design (init once), alongside the MCP wiring.
+    const skill = writeSkill(client, { force: opts.force });
+    if (skill === "installed") console.log(`  + Agent Skill installed (${skillTargetDir(client)})`);
+    else if (skill === "skipped")
+      console.log(`  - Agent Skill already present for ${client} (use --force to refresh)`);
   }
   if (clients.length === 0) {
     console.log("  - editor setup skipped");
@@ -918,6 +994,8 @@ export async function uninstallProject(opts: {
       // Solution-level only — --global is meaningless, same as init.
       bump(removeServerEntryFile(path.join(root, ".mcp.json"), "servers"));
     }
+    // D54: remove the Agent Skill installed by init.
+    bump(removeSkill(client));
   }
   // Copilot instructions: init may have written personal (default) or project.
   if (clients.some((c) => c !== "opencode")) {

package/src/tools/ops.ts

@@ -71,7 +71,7 @@ export const TOOL_DESCRIPTIONS = {
     "Replace an existing memory with a newer version. The old memory is kept as history (status: superseded) and retrieval returns the new one. Use when a saved fact becomes outdated and should be replaced rather than duplicated.",
   memory_forget: "Delete a memory by id. Use when the user asks to forget something.",
   memory_status:
-    "Show the project memory sync pipeline: drafts waiting in the outbox (appdata), memories in the repo awaiting review or published, and any repo files not yet committed. Call this at session start and at task checkpoints, then ask the user which drafts to sync. The user may also trigger this flow by saying 'sync memory' (or '同步记忆').",
+    "Show the project memory sync pipeline: drafts waiting in the outbox (appdata), memories in the repo awaiting review or published, and any repo files not yet committed. Call this at session start, when the server reports drafts waiting for review, or when the user says 'sync memory' (or '同步记忆'); then ask the user which drafts to sync.",
   memory_submit:
     "Move outbox drafts into the repo memory dir for review: copies the drafts in as proposed (or keeps a local approval), commits locally on the current branch, and moves the outbox originals out. Never creates a branch on its own — pass branch= only with the user's explicit approval for the full chain. Prints the push and PR commands — those need the user's explicit approval and are never run automatically.",
   memory_propose:
@@ -104,7 +104,7 @@ export const memoryAddArgs = {
     .string()
     .optional()
     .describe(
-      "Where this memory came from. Default: tool. Pass 'inference' for agent-proposed captures at checkpoints (V2-DESIGN §3.5).",
+      "Where this memory came from. Default: tool. Pass 'inference' for agent-proposed captures (V2-DESIGN §3.5).",
     ),
 };
 export type MemoryAddArgs = z.infer<z.ZodObject<typeof memoryAddArgs>>;