@brianluby/agent-brain 1.1.0

package/dist/scripts/timeline.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, renameSync, unlinkSync } from 'fs';
+import { relative, basename, dirname, resolve, isAbsolute, sep } from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+function defaultPlatformRelativePath(platform) {
+  const normalizedPlatform = platform.trim().toLowerCase();
+  const safePlatform = normalizedPlatform.replace(/[^a-z0-9_-]/g, "-").replace(/^-+|-+$/g, "") || "unknown";
+  return `.agent-brain/mind-${safePlatform}.mv2`;
+}
+function resolveInsideProject(projectDir, candidatePath) {
+  if (isAbsolute(candidatePath)) {
+    return resolve(candidatePath);
+  }
+  const root = resolve(projectDir);
+  const resolved = resolve(root, candidatePath);
+  const rel = relative(root, resolved);
+  if (rel === ".." || rel.startsWith(`..${sep}`)) {
+    throw new Error("Resolved memory path must stay inside projectDir");
+  }
+  return resolved;
+}
+function resolveMemoryPathPolicy(input) {
+  const mode = input.platformOptIn ? "platform_opt_in" : "legacy_first";
+  const canonicalRelativePath = input.platformOptIn ? input.platformRelativePath || defaultPlatformRelativePath(input.platform) : input.defaultRelativePath;
+  const canonicalPath = resolveInsideProject(input.projectDir, canonicalRelativePath);
+  if (existsSync(canonicalPath)) {
+    return {
+      mode,
+      memoryPath: canonicalPath,
+      canonicalPath
+    };
+  }
+  const fallbackPaths = (input.legacyRelativePaths || []).map((relativePath) => resolveInsideProject(input.projectDir, relativePath));
+  for (const fallbackPath of fallbackPaths) {
+    if (existsSync(fallbackPath)) {
+      return {
+        mode,
+        memoryPath: fallbackPath,
+        canonicalPath,
+        migrationSuggestion: {
+          fromPath: fallbackPath,
+          toPath: canonicalPath
+        }
+      };
+    }
+  }
+  if (input.platformOptIn) {
+    return {
+      mode: "platform_opt_in",
+      memoryPath: canonicalPath,
+      canonicalPath
+    };
+  }
+  return {
+    mode: "legacy_first",
+    memoryPath: canonicalPath,
+    canonicalPath
+  };
+}
+
+// src/platforms/platform-detector.ts
+function normalizePlatform(value) {
+  if (!value) return void 0;
+  const normalized = value.trim().toLowerCase();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function detectPlatformFromEnv() {
+  const explicitFromEnv = normalizePlatform(process.env.MEMVID_PLATFORM);
+  if (explicitFromEnv) {
+    return explicitFromEnv;
+  }
+  if (process.env.OPENCODE === "1") {
+    return "opencode";
+  }
+  return "claude";
+}
+
+// src/scripts/utils.ts
+async function createFreshMemory(memoryPath, create) {
+  const memoryDir = dirname(memoryPath);
+  mkdirSync(memoryDir, { recursive: true });
+  await create(memoryPath, "basic");
+}
+function isCorruptedMemoryError(error) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  return errorMessage.includes("Deserialization") || errorMessage.includes("UnexpectedVariant") || errorMessage.includes("Invalid") || errorMessage.includes("corrupt") || errorMessage.includes("version mismatch") || errorMessage.includes("validation failed") || errorMessage.includes("unable to recover") || errorMessage.includes("table of contents");
+}
+async function handleCorruptedMemory(memoryPath, create) {
+  console.log(
+    "\u26A0\uFE0F  Memory file is corrupted or incompatible. Creating fresh memory..."
+  );
+  const backupPath = `${memoryPath}.backup-${Date.now()}`;
+  try {
+    renameSync(memoryPath, backupPath);
+    console.log(`   Old file backed up to: ${backupPath}`);
+  } catch {
+    try {
+      unlinkSync(memoryPath);
+    } catch {
+    }
+  }
+  await createFreshMemory(memoryPath, create);
+}
+async function openMemorySafely(memoryPath, use, create) {
+  if (!existsSync(memoryPath)) {
+    console.log("No memory file found. Creating new memory at:", memoryPath);
+    await createFreshMemory(memoryPath, create);
+    return { memvid: null, isNew: true };
+  }
+  try {
+    const memvid = await use("basic", memoryPath);
+    return { memvid, isNew: false };
+  } catch (openError) {
+    if (isCorruptedMemoryError(openError)) {
+      await handleCorruptedMemory(memoryPath, create);
+      return { memvid: null, isNew: true };
+    }
+    throw openError;
+  }
+}
+function resolveScriptMemoryPath(projectDir) {
+  const pathPolicy = resolveMemoryPathPolicy({
+    projectDir,
+    platform: detectPlatformFromEnv(),
+    defaultRelativePath: ".agent-brain/mind.mv2",
+    legacyRelativePaths: [".claude/mind.mv2"],
+    platformRelativePath: process.env.MEMVID_PLATFORM_MEMORY_PATH,
+    platformOptIn: process.env.MEMVID_PLATFORM_PATH_OPT_IN === "1"
+  });
+  if (!pathPolicy.migrationSuggestion) {
+    return { memoryPath: pathPolicy.memoryPath };
+  }
+  const fromDisplay = relative(projectDir, pathPolicy.migrationSuggestion.fromPath) || basename(pathPolicy.migrationSuggestion.fromPath);
+  const toDisplay = relative(projectDir, pathPolicy.migrationSuggestion.toPath) || basename(pathPolicy.migrationSuggestion.toPath);
+  return {
+    memoryPath: pathPolicy.memoryPath,
+    migrationPrompt: `mkdir -p "${dirname(toDisplay)}" && mv "${fromDisplay}" "${toDisplay}"`
+  };
+}
+
+// src/scripts/timeline.ts
+async function ensureDeps() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const pluginRoot = resolve(__dirname, "../..");
+  const sdkPath = resolve(pluginRoot, "node_modules/@memvid/sdk");
+  if (!existsSync(sdkPath)) {
+    console.log("Installing dependencies...");
+    try {
+      execSync("npm install --production --no-fund --no-audit", {
+        cwd: pluginRoot,
+        stdio: "inherit",
+        timeout: 12e4
+      });
+    } catch {
+      console.error("Failed to install dependencies. Please run: npm install");
+      process.exit(1);
+    }
+  }
+}
+async function loadSDK() {
+  await ensureDeps();
+  return await import('@memvid/sdk');
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const limit = parseInt(args[0] || "10", 10);
+  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.OPENCODE_PROJECT_DIR || process.cwd();
+  const { memoryPath, migrationPrompt } = resolveScriptMemoryPath(projectDir);
+  if (migrationPrompt) {
+    console.log("Legacy memory detected at .claude/mind.mv2.");
+    console.log(`Move it to .agent-brain/mind.mv2? Run: ${migrationPrompt}
+`);
+  }
+  const { use, create } = await loadSDK();
+  const { memvid, isNew } = await openMemorySafely(memoryPath, use, create);
+  if (isNew || !memvid) {
+    console.log("\u2705 Memory initialized! No memories to show yet.\n");
+    process.exit(0);
+  }
+  try {
+    const mv = memvid;
+    const timeline = await mv.timeline({ limit, reverse: true });
+    const frames = Array.isArray(timeline) ? timeline : timeline.frames || [];
+    if (frames.length === 0) {
+      console.log("No memories yet. Start using Claude to build your memory!");
+      process.exit(0);
+    }
+    console.log(`Recent ${frames.length} memories:
+`);
+    for (let i = 0; i < frames.length; i++) {
+      const frame = frames[i];
+      const preview = frame.preview || "";
+      const uri = frame.uri || `frame/${frame.frame_id}`;
+      const timestamp = frame.timestamp ? new Date(frame.timestamp * 1e3).toLocaleString() : "Unknown time";
+      const snippet = preview.slice(0, 100).replace(/\n/g, " ");
+      console.log(`#${i + 1} ${uri}`);
+      console.log(`   \u{1F4C5} ${timestamp}`);
+      console.log(`   ${snippet}${snippet.length >= 100 ? "..." : ""}`);
+      console.log();
+    }
+  } catch (error) {
+    console.error("Error reading timeline:", error);
+    process.exit(1);
+  }
+}
+main();
+//# sourceMappingURL=timeline.js.map
+//# sourceMappingURL=timeline.js.map

package/dist/scripts/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/platforms/path-policy.ts","../../src/platforms/platform-detector.ts","../../src/scripts/utils.ts","../../src/scripts/timeline.ts"],"names":["pathRelative","existsSync","dirname","resolve"],"mappings":"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","file":"timeline.js","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { isAbsolute, relative as pathRelative, resolve, sep } from \"node:path\";\n\nexport type MemoryPathMode = \"legacy_first\" | \"platform_opt_in\";\n\nexport interface MemoryPathPolicyInput {\n  projectDir: string;\n  platform: string;\n  defaultRelativePath: string;\n  platformRelativePath?: string;\n  platformOptIn?: boolean;\n  legacyRelativePaths?: string[];\n}\n\nexport interface MemoryMigrationSuggestion {\n  fromPath: string;\n  toPath: string;\n}\n\nexport interface MemoryPathPolicyResult {\n  mode: MemoryPathMode;\n  memoryPath: string;\n  canonicalPath: string;\n  migrationSuggestion?: MemoryMigrationSuggestion;\n}\n\nfunction defaultPlatformRelativePath(platform: string): string {\n  const normalizedPlatform = platform.trim().toLowerCase();\n  const safePlatform = normalizedPlatform\n    .replace(/[^a-z0-9_-]/g, \"-\")\n    .replace(/^-+|-+$/g, \"\") || \"unknown\";\n  return `.agent-brain/mind-${safePlatform}.mv2`;\n}\n\nfunction resolveInsideProject(projectDir: string, candidatePath: string): string {\n  if (isAbsolute(candidatePath)) {\n    return resolve(candidatePath);\n  }\n  const root = resolve(projectDir);\n  const resolved = resolve(root, candidatePath);\n  const rel = pathRelative(root, resolved);\n  if (rel === \"..\" || rel.startsWith(`..${sep}`)) {\n    throw new Error(\"Resolved memory path must stay inside projectDir\");\n  }\n  return resolved;\n}\n\nexport function resolveMemoryPathPolicy(input: MemoryPathPolicyInput): MemoryPathPolicyResult {\n  const mode: MemoryPathMode = input.platformOptIn ? \"platform_opt_in\" : \"legacy_first\";\n  const canonicalRelativePath = input.platformOptIn\n    ? input.platformRelativePath || defaultPlatformRelativePath(input.platform)\n    : input.defaultRelativePath;\n  const canonicalPath = resolveInsideProject(input.projectDir, canonicalRelativePath);\n\n  if (existsSync(canonicalPath)) {\n    return {\n      mode,\n      memoryPath: canonicalPath,\n      canonicalPath,\n    };\n  }\n\n  const fallbackPaths = (input.legacyRelativePaths || [])\n    .map((relativePath) => resolveInsideProject(input.projectDir, relativePath));\n\n  for (const fallbackPath of fallbackPaths) {\n    if (existsSync(fallbackPath)) {\n      return {\n        mode,\n        memoryPath: fallbackPath,\n        canonicalPath,\n        migrationSuggestion: {\n          fromPath: fallbackPath,\n          toPath: canonicalPath,\n        },\n      };\n    }\n  }\n\n  if (input.platformOptIn) {\n    return {\n      mode: \"platform_opt_in\",\n      memoryPath: canonicalPath,\n      canonicalPath,\n    };\n  }\n\n  return {\n    mode: \"legacy_first\",\n    memoryPath: canonicalPath,\n    canonicalPath,\n  };\n}\n","import type { HookInput } from \"../types.js\";\n\nfunction normalizePlatform(value: string | undefined): string | undefined {\n  if (!value) return undefined;\n  const normalized = value.trim().toLowerCase();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nexport function detectPlatformFromEnv(): string {\n  const explicitFromEnv = normalizePlatform(process.env.MEMVID_PLATFORM);\n  if (explicitFromEnv) {\n    return explicitFromEnv;\n  }\n\n  if (process.env.OPENCODE === \"1\") {\n    return \"opencode\";\n  }\n\n  return \"claude\";\n}\n\nexport function detectPlatform(input: HookInput): string {\n  const explicitFromHook = normalizePlatform(input.platform);\n  if (explicitFromHook) {\n    return explicitFromHook;\n  }\n\n  return detectPlatformFromEnv();\n}\n","/**\n * Shared utilities for Memvid Mind scripts\n */\n\nimport { existsSync, mkdirSync, unlinkSync, renameSync } from \"node:fs\";\nimport { basename, dirname, relative } from \"node:path\";\nimport { resolveMemoryPathPolicy } from \"../platforms/path-policy.js\";\nimport { detectPlatformFromEnv } from \"../platforms/platform-detector.js\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CreateFn = (path: string, kind: any) => Promise<any>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype UseFn = (kind: any, path: string) => Promise<any>;\n\n/**\n * Create a fresh memory file at the given path\n */\nexport async function createFreshMemory(\n  memoryPath: string,\n  create: CreateFn\n): Promise<void> {\n  const memoryDir = dirname(memoryPath);\n  mkdirSync(memoryDir, { recursive: true });\n  await create(memoryPath, \"basic\");\n}\n\n/**\n * Check if an error indicates a corrupted or incompatible memory file\n */\nexport function isCorruptedMemoryError(error: unknown): boolean {\n  const errorMessage =\n    error instanceof Error ? error.message : String(error);\n  return (\n    errorMessage.includes(\"Deserialization\") ||\n    errorMessage.includes(\"UnexpectedVariant\") ||\n    errorMessage.includes(\"Invalid\") ||\n    errorMessage.includes(\"corrupt\") ||\n    errorMessage.includes(\"version mismatch\") ||\n    errorMessage.includes(\"validation failed\") ||\n    errorMessage.includes(\"unable to recover\") ||\n    errorMessage.includes(\"table of contents\")\n  );\n}\n\n/**\n * Handle corrupted memory file by backing it up and creating a fresh one\n */\nexport async function handleCorruptedMemory(\n  memoryPath: string,\n  create: CreateFn\n): Promise<void> {\n  console.log(\n    \"⚠️  Memory file is corrupted or incompatible. Creating fresh memory...\"\n  );\n  // Backup corrupted file\n  const backupPath = `${memoryPath}.backup-${Date.now()}`;\n  try {\n    renameSync(memoryPath, backupPath);\n    console.log(`   Old file backed up to: ${backupPath}`);\n  } catch {\n    try {\n      unlinkSync(memoryPath);\n    } catch {\n      // Ignore unlink errors\n    }\n  }\n  await createFreshMemory(memoryPath, create);\n}\n\n/**\n * Open a memory file, handling corruption by creating fresh memory if needed\n * Returns the opened memvid instance, or null if memory was recreated (caller should exit)\n */\nexport async function openMemorySafely(\n  memoryPath: string,\n  use: UseFn,\n  create: CreateFn\n): Promise<{ memvid: unknown; isNew: boolean }> {\n  // Auto-create if doesn't exist\n  if (!existsSync(memoryPath)) {\n    console.log(\"No memory file found. Creating new memory at:\", memoryPath);\n    await createFreshMemory(memoryPath, create);\n    return { memvid: null, isNew: true };\n  }\n\n  // Try to open, handle corrupted files\n  try {\n    const memvid = await use(\"basic\", memoryPath);\n    return { memvid, isNew: false };\n  } catch (openError: unknown) {\n    if (isCorruptedMemoryError(openError)) {\n      await handleCorruptedMemory(memoryPath, create);\n      return { memvid: null, isNew: true };\n    }\n    // Re-throw other errors\n    throw openError;\n  }\n}\n\nexport interface ScriptMemoryPathResult {\n  memoryPath: string;\n  migrationPrompt?: string;\n}\n\nexport function resolveScriptMemoryPath(projectDir: string): ScriptMemoryPathResult {\n  const pathPolicy = resolveMemoryPathPolicy({\n    projectDir,\n    platform: detectPlatformFromEnv(),\n    defaultRelativePath: \".agent-brain/mind.mv2\",\n    legacyRelativePaths: [\".claude/mind.mv2\"],\n    platformRelativePath: process.env.MEMVID_PLATFORM_MEMORY_PATH,\n    platformOptIn: process.env.MEMVID_PLATFORM_PATH_OPT_IN === \"1\",\n  });\n\n  if (!pathPolicy.migrationSuggestion) {\n    return { memoryPath: pathPolicy.memoryPath };\n  }\n\n  const fromDisplay = relative(projectDir, pathPolicy.migrationSuggestion.fromPath) || basename(pathPolicy.migrationSuggestion.fromPath);\n  const toDisplay = relative(projectDir, pathPolicy.migrationSuggestion.toPath) || basename(pathPolicy.migrationSuggestion.toPath);\n  return {\n    memoryPath: pathPolicy.memoryPath,\n    migrationPrompt: `mkdir -p \"${dirname(toDisplay)}\" && mv \"${fromDisplay}\" \"${toDisplay}\"`,\n  };\n}\n","#!/usr/bin/env node\n/**\n * Memvid Mind - Timeline Script\n *\n * View recent memories using the SDK (no CLI dependency)\n */\n\nimport { existsSync } from \"node:fs\";\nimport { resolve, dirname } from \"node:path\";\nimport { execSync } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { openMemorySafely, resolveScriptMemoryPath } from \"./utils.js\";\n\n// Ensure dependencies are installed before importing SDK\nasync function ensureDeps() {\n  const __dirname = dirname(fileURLToPath(import.meta.url));\n  const pluginRoot = resolve(__dirname, \"../..\");\n  const sdkPath = resolve(pluginRoot, \"node_modules/@memvid/sdk\");\n\n  if (!existsSync(sdkPath)) {\n    console.log(\"Installing dependencies...\");\n    try {\n      execSync(\"npm install --production --no-fund --no-audit\", {\n        cwd: pluginRoot,\n        stdio: \"inherit\",\n        timeout: 120000,\n      });\n    } catch {\n      console.error(\"Failed to install dependencies. Please run: npm install\");\n      process.exit(1);\n    }\n  }\n}\n\n// Dynamic import for SDK\nasync function loadSDK() {\n  await ensureDeps();\n  return await import(\"@memvid/sdk\");\n}\n\nasync function main() {\n  const args = process.argv.slice(2);\n  const limit = parseInt(args[0] || \"10\", 10);\n\n  // Get memory file path\n  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.OPENCODE_PROJECT_DIR || process.cwd();\n  const { memoryPath, migrationPrompt } = resolveScriptMemoryPath(projectDir);\n\n  if (migrationPrompt) {\n    console.log(\"Legacy memory detected at .claude/mind.mv2.\");\n    console.log(`Move it to .agent-brain/mind.mv2? Run: ${migrationPrompt}\\n`);\n  }\n\n  // Load SDK dynamically\n  const { use, create } = await loadSDK();\n\n  // Open memory safely (handles corrupted files)\n  const { memvid, isNew } = await openMemorySafely(memoryPath, use, create);\n\n  if (isNew || !memvid) {\n    console.log(\"✅ Memory initialized! No memories to show yet.\\n\");\n    process.exit(0);\n  }\n\n  try {\n    const mv = memvid as any;\n    const timeline = await mv.timeline({ limit, reverse: true });\n\n    // SDK returns array directly or { frames: [...] }\n    const frames = Array.isArray(timeline) ? timeline : timeline.frames || [];\n\n    if (frames.length === 0) {\n      console.log(\"No memories yet. Start using Claude to build your memory!\");\n      process.exit(0);\n    }\n\n    console.log(`Recent ${frames.length} memories:\\n`);\n\n    for (let i = 0; i < frames.length; i++) {\n      const frame = frames[i];\n      const preview = frame.preview || \"\";\n      const uri = frame.uri || `frame/${frame.frame_id}`;\n      const timestamp = frame.timestamp\n        ? new Date(frame.timestamp * 1000).toLocaleString()\n        : \"Unknown time\";\n      const snippet = preview.slice(0, 100).replace(/\\n/g, \" \");\n\n      console.log(`#${i + 1} ${uri}`);\n      console.log(`   📅 ${timestamp}`);\n      console.log(`   ${snippet}${snippet.length >= 100 ? \"...\" : \"\"}`);\n      console.log();\n    }\n  } catch (error) {\n    console.error(\"Error reading timeline:\", error);\n    process.exit(1);\n  }\n}\n\nmain();\n"]}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@brianluby/agent-brain",
+  "version": "1.1.0",
+  "description": "Give Claude Code photographic memory in ONE portable file",
+  "type": "module",
+  "main": "dist/opencode/plugin.js",
+  "types": "dist/opencode/plugin.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/opencode/plugin.d.ts",
+      "default": "./dist/opencode/plugin.js"
+    },
+    "./mind": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./opencode": {
+      "types": "./dist/opencode/plugin.d.ts",
+      "default": "./dist/opencode/plugin.js"
+    }
+  },
+  "opencode": {
+    "type": "plugin",
+    "hooks": [
+      "chat.message",
+      "tool.execute.after",
+      "event"
+    ]
+  },
+  "scripts": {
+    "build": "tsup && cp src/hooks/hooks.json dist/hooks/",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "commands",
+    ".claude-plugin"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "claude-code-plugin",
+    "anthropic",
+    "opencode",
+    "opencode-plugin",
+    "memory",
+    "ai-memory",
+    "context-persistence",
+    "memvid",
+    "portable-memory",
+    "persistent-memory",
+    "llm-memory",
+    "ai-assistant"
+  ],
+  "author": "Memvid <hello@memvid.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brianluby/Agent-brain.git"
+  },
+  "homepage": "https://memvid.com",
+  "bugs": {
+    "url": "https://github.com/brianluby/Agent-brain/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.2.10",
+    "@memvid/sdk": "^2.0.149",
+    "proper-lockfile": "^4.1.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^22.0.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "eslint": "^9.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.50.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/skills/memory/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: memory
+description: Claude Mind - Search and manage Claude's persistent memory stored in a single portable .mv2 file
+---
+
+# Claude Mind
+
+You have access to a persistent memory system powered by Claude Mind. All your observations, discoveries, and learnings are stored in a single `.agent-brain/mind.mv2` file.
+
+## How to Execute Memory Commands
+
+Use the bundled SDK scripts via Node.js (NOT the CLI). The scripts are at `${CLAUDE_PLUGIN_ROOT}/dist/scripts/`.
+
+### Search Memories
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "<query>" [limit]
+```
+
+Examples:
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "authentication" 5`
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "database schema" 10`
+
+### Ask Questions
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "<question>"
+```
+
+Examples:
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "Why did we choose React?"`
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "What was the CORS solution?"`
+
+### View Statistics
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/stats.js"
+```
+
+### View Recent Memories
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/timeline.js" [count]
+```
+
+## Memory Types
+
+Memories are automatically classified into these types:
+- **discovery** - New information discovered
+- **decision** - Important decisions made
+- **problem** - Problems or errors encountered
+- **solution** - Solutions implemented
+- **pattern** - Patterns recognized in code/data
+- **warning** - Warnings or concerns noted
+- **success** - Successful outcomes
+- **refactor** - Code refactoring done
+- **bugfix** - Bugs fixed
+- **feature** - Features added
+
+## File Location
+
+Your memory is stored at: `.agent-brain/mind.mv2`
+
+This file is:
+- **Portable** - Copy it anywhere, share with teammates
+- **Git-friendly** - Commit to version control
+- **Self-contained** - Everything in ONE file
+- **Searchable** - Instant semantic search
+
+## Usage Tips
+
+1. **Start of session**: Recent memories are automatically injected as context
+2. **During coding**: Observations are captured automatically from tool use
+3. **Searching**: Use natural language queries to find relevant past context
+4. **Sharing**: Send the `.mind.mv2` file to teammates for instant onboarding

package/skills/mind/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: mind
+description: Claude Mind - Search and manage Claude's persistent memory stored in a single portable .mv2 file
+---
+
+# Claude Mind
+
+You have access to a persistent memory system powered by Claude Mind. All your observations, discoveries, and learnings are stored in a single `.agent-brain/mind.mv2` file.
+
+## How to Execute Memory Commands
+
+Use the bundled SDK scripts via Node.js (NOT the CLI). The scripts are at `${CLAUDE_PLUGIN_ROOT}/dist/scripts/`.
+
+### Search Memories
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "<query>" [limit]
+```
+
+Examples:
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "authentication" 5`
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/find.js" "database schema" 10`
+
+### Ask Questions
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "<question>"
+```
+
+Examples:
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "Why did we choose React?"`
+- `node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/ask.js" "What was the CORS solution?"`
+
+### View Statistics
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/stats.js"
+```
+
+### View Recent Memories
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/dist/scripts/timeline.js" [count]
+```
+
+## Memory Types
+
+Memories are automatically classified into these types:
+- **discovery** - New information discovered
+- **decision** - Important decisions made
+- **problem** - Problems or errors encountered
+- **solution** - Solutions implemented
+- **pattern** - Patterns recognized in code/data
+- **warning** - Warnings or concerns noted
+- **success** - Successful outcomes
+- **refactor** - Code refactoring done
+- **bugfix** - Bugs fixed
+- **feature** - Features added
+
+## File Location
+
+Your memory is stored at: `.agent-brain/mind.mv2`
+
+This file is:
+- **Portable** - Copy it anywhere, share with teammates
+- **Git-friendly** - Commit to version control
+- **Self-contained** - Everything in ONE file
+- **Searchable** - Instant semantic search
+
+## Usage Tips
+
+1. **Start of session**: Recent memories are automatically injected as context
+2. **During coding**: Observations are captured automatically from tool use
+3. **Searching**: Use natural language queries to find relevant past context
+4. **Sharing**: Send the `.mind.mv2` file to teammates for instant onboarding