myagentmemory 0.4.5 → 0.4.6

package/README.md

@@ -23,8 +23,7 @@ bun run build:cli
 agent-memory init
 
 # Install skill files for Claude Code, Codex, Cursor, and Agent
-bash scripts/install-skills.sh
-pwsh -File scripts/install-skills.ps1
+agent-memory install-skills
 ```
 
 This installs:
@@ -84,6 +83,7 @@ The memory directory defaults to `~/.agent-memory/`. Override with `AGENT_MEMORY
 | `agent-memory read --target <long_term\|scratchpad\|daily\|list> [--date YYYY-MM-DD]` | Read memory files |
 | `agent-memory scratchpad <add\|done\|undo\|clear_done\|list> [--text <text>]` | Manage checklist |
 | `agent-memory search --query <text> [--mode keyword\|semantic\|deep] [--limit N]` | Search via qmd |
+| `agent-memory install-skills` | Install bundled SKILL.md files into local agent directories |
 | `agent-memory init` | Create dirs, detect qmd, setup collection |
 | `agent-memory status` | Show config, qmd status, file counts |
 
@@ -186,8 +186,7 @@ bun run build:cli
 agent-memory write --target long_term --content "test" && agent-memory read --target long_term
 
 # Install skills
-bash scripts/install-skills.sh
-pwsh -File scripts/install-skills.ps1
+agent-memory install-skills
 ```
 
 ## Publishing (maintainers)

package/dist/cli.d.ts

@@ -4,6 +4,7 @@
  *
  * Subcommands:
  *   version    — Print binary version
+ *   install-skills — Install SKILL.md files into local agent directories
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files

package/dist/cli.js

@@ -4,6 +4,7 @@
  *
  * Subcommands:
  *   version    — Print binary version
+ *   install-skills — Install SKILL.md files into local agent directories
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files
@@ -18,7 +19,7 @@
  */
 import * as fs from "node:fs";
 const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "dev";
-import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, ensureDirs, ensureQmdAvailableForSync, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdEmbedMode, getQmdHealth, getQmdResultPath, getQmdResultText, getScratchpadFile, nowTimestamp, parseScratchpad, readFileSafe, runQmdEmbedDetached, runQmdSearch, runQmdSync, runQmdUpdateNow, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, todayStr, } from "./core.js";
+import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, ensureDirs, ensureQmdAvailableForSync, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdEmbedMode, getQmdHealth, getQmdResultPath, getQmdResultText, getScratchpadFile, installSkills, nowTimestamp, parseScratchpad, readFileSafe, runQmdEmbedDetached, runQmdSearch, runQmdSync, runQmdUpdateNow, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, todayStr, } from "./core.js";
 function parseArgs(argv) {
     const flags = {};
     const positional = [];
@@ -321,6 +322,37 @@ async function cmdSearch(flags) {
         exitError(`Search failed: ${err instanceof Error ? err.message : String(err)}`, json);
     }
 }
+function cmdInstallSkills(flags) {
+    const json = hasFlag(flags, "json");
+    const report = installSkills();
+    if (!report.ok) {
+        exitError(report.error ?? "Failed to install skills.", json);
+    }
+    if (json) {
+        output(report, true);
+        return;
+    }
+    if (report.detected.length === 0) {
+        console.log("No supported agent installations detected.");
+    }
+    else {
+        const detectedLabels = report.detected.map((item) => item.label).join(", ");
+        console.log(`Detected: ${detectedLabels}`);
+    }
+    if (report.installed.length === 0) {
+        console.log("No skills installed.");
+    }
+    else {
+        for (const item of report.installed) {
+            console.log(`Installed ${item.label}: ${item.path}`);
+        }
+    }
+    if (report.skipped.length > 0) {
+        for (const item of report.skipped) {
+            console.log(`Skipped ${item.label} (${item.reason})`);
+        }
+    }
+}
 async function cmdSync(flags) {
     const json = hasFlag(flags, "json");
     ensureDirs();
@@ -511,6 +543,7 @@ Usage:
 
 Commands:
   version     Show binary version
+  install-skills  Install bundled skills into local agent directories
   context     Build & print context injection string
   write       Write to memory files
   read        Read memory files
@@ -574,6 +607,9 @@ async function main() {
         case "search":
             await cmdSearch(flags);
             break;
+        case "install-skills":
+            cmdInstallSkills(flags);
+            break;
         case "sync":
             await cmdSync(flags);
             break;

package/dist/core.d.ts

@@ -65,6 +65,10 @@ type SpawnFn = typeof spawn;
 export declare function _setExecFileForTest(fn: ExecFileFn): void;
 /** Reset execFile implementation (for testing). */
 export declare function _resetExecFileForTest(): void;
+/** Override skills root directory (for testing). */
+export declare function _setSkillsRootForTest(dir: string | null): void;
+/** Override home directory (for testing). */
+export declare function _setHomeDirForTest(dir: string | null): void;
 /** Override spawn implementation (for testing). */
 export declare function _setSpawnForTest(fn: SpawnFn): void;
 /** Reset spawn implementation (for testing). */
@@ -104,6 +108,25 @@ export declare function runQmdSync(): Promise<{
     updateOk: boolean;
     embedOk: boolean;
 }>;
+export interface InstallSkillsReport {
+    ok: boolean;
+    projectDir?: string;
+    homeDir?: string;
+    detected: Array<{
+        label: string;
+        homeMarker: string;
+    }>;
+    installed: Array<{
+        label: string;
+        path: string;
+    }>;
+    skipped: Array<{
+        label: string;
+        reason: string;
+    }>;
+    error?: string;
+}
+export declare function installSkills(): InstallSkillsReport;
 export interface QmdHealthInfo {
     totalFiles: number | null;
     vectorsEmbedded: number | null;

package/dist/core.js

@@ -284,6 +284,8 @@ let spawnFn = spawn;
 let qmdAvailable = false;
 let updateTimer = null;
 let embedTimer = null;
+let skillsRootOverride = null;
+let homeDirOverride = null;
 /** QMD collection name — configurable per platform. */
 let QMD_COLLECTION_NAME = "agent-memory";
 /** Override execFile implementation (for testing). */
@@ -294,6 +296,14 @@ export function _setExecFileForTest(fn) {
 export function _resetExecFileForTest() {
     execFileFn = execFile;
 }
+/** Override skills root directory (for testing). */
+export function _setSkillsRootForTest(dir) {
+    skillsRootOverride = dir;
+}
+/** Override home directory (for testing). */
+export function _setHomeDirForTest(dir) {
+    homeDirOverride = dir;
+}
 /** Override spawn implementation (for testing). */
 export function _setSpawnForTest(fn) {
     spawnFn = fn;
@@ -332,6 +342,40 @@ export function _clearEmbedTimer() {
         embedTimer = null;
     }
 }
+function resolveHomeDir() {
+    if (homeDirOverride !== null)
+        return homeDirOverride;
+    return process.env.HOME ?? process.env.USERPROFILE ?? null;
+}
+function findSkillsRoot() {
+    const envRoot = process.env.AGENT_MEMORY_SKILLS_ROOT;
+    if (envRoot)
+        return envRoot;
+    if (skillsRootOverride)
+        return skillsRootOverride;
+    const scanUp = (startDir) => {
+        let dir = startDir;
+        while (true) {
+            if (fs.existsSync(path.join(dir, "skills")))
+                return dir;
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    };
+    const argvPath = process.argv[1];
+    if (argvPath) {
+        const found = scanUp(path.resolve(path.dirname(argvPath)));
+        if (found)
+            return found;
+    }
+    const execDir = path.dirname(process.execPath);
+    const found = scanUp(path.resolve(execDir));
+    if (found)
+        return found;
+    return scanUp(path.resolve(process.cwd()));
+}
 /** Get the current QMD collection name. */
 export function getCollectionName() {
     return QMD_COLLECTION_NAME;
@@ -528,6 +572,93 @@ export async function runQmdSync() {
     const embedOk = await runQmdEmbedNow();
     return { updateOk, embedOk };
 }
+export function installSkills() {
+    const homeDir = resolveHomeDir();
+    if (!homeDir) {
+        return {
+            ok: false,
+            detected: [],
+            installed: [],
+            skipped: [],
+            error: "Home directory not found. Set HOME (or USERPROFILE on Windows) and retry.",
+        };
+    }
+    const projectDir = findSkillsRoot();
+    if (!projectDir) {
+        return {
+            ok: false,
+            homeDir,
+            detected: [],
+            installed: [],
+            skipped: [],
+            error: "Could not locate the skills directory. Ensure the package includes skills/ (reinstall if needed).",
+        };
+    }
+    const skillsDir = path.join(projectDir, "skills");
+    if (!fs.existsSync(skillsDir)) {
+        return {
+            ok: false,
+            projectDir,
+            homeDir,
+            detected: [],
+            installed: [],
+            skipped: [],
+            error: `Skills directory not found: ${skillsDir}`,
+        };
+    }
+    const targets = [
+        {
+            label: "Claude Code skill",
+            srcDir: path.join(skillsDir, "claude-code"),
+            destDir: path.join(homeDir, ".claude", "skills", "agent-memory"),
+            homeMarker: path.join(homeDir, ".claude"),
+        },
+        {
+            label: "Codex skill",
+            srcDir: path.join(skillsDir, "codex"),
+            destDir: path.join(homeDir, ".codex", "skills", "agent-memory"),
+            homeMarker: path.join(homeDir, ".codex"),
+        },
+        {
+            label: "Cursor skill",
+            srcDir: path.join(skillsDir, "cursor"),
+            destDir: path.join(homeDir, ".cursor", "skills", "agent-memory"),
+            homeMarker: path.join(homeDir, ".cursor"),
+        },
+        {
+            label: "Agent CLI skill",
+            srcDir: path.join(skillsDir, "agent"),
+            destDir: path.join(homeDir, ".agents", "skills", "agent-memory"),
+            homeMarker: path.join(homeDir, ".agents"),
+        },
+    ];
+    const detected = [];
+    const installed = [];
+    const skipped = [];
+    for (const target of targets) {
+        if (!fs.existsSync(target.homeMarker)) {
+            skipped.push({ label: target.label, reason: `${target.homeMarker} not found` });
+            continue;
+        }
+        detected.push({ label: target.label, homeMarker: target.homeMarker });
+        const skillFile = path.join(target.srcDir, "SKILL.md");
+        if (!fs.existsSync(skillFile)) {
+            skipped.push({ label: target.label, reason: `${skillFile} not found` });
+            continue;
+        }
+        fs.mkdirSync(target.destDir, { recursive: true });
+        fs.copyFileSync(skillFile, path.join(target.destDir, "SKILL.md"));
+        installed.push({ label: target.label, path: path.join(target.destDir, "SKILL.md") });
+    }
+    return {
+        ok: true,
+        projectDir,
+        homeDir,
+        detected,
+        installed,
+        skipped,
+    };
+}
 export function parseQmdStatus(stdout, collectionName) {
     const result = {
         totalFiles: null,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "myagentmemory",
-	"version": "0.4.5",
+	"version": "0.4.6",
 	"description": "Persistent memory for coding agents (Claude Code, Codex, Cursor, Agent) with qmd-powered semantic search across daily logs, long-term memory, and scratchpad",
 	"main": "./dist/core.js",
 	"types": "./dist/core.d.ts",

package/src/cli.ts

@@ -4,6 +4,7 @@
  *
  * Subcommands:
  *   version    — Print binary version
+ *   install-skills — Install SKILL.md files into local agent directories
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files
@@ -40,6 +41,7 @@ import {
 	getQmdResultPath,
 	getQmdResultText,
 	getScratchpadFile,
+	installSkills,
 	nowTimestamp,
 	parseScratchpad,
 	readFileSafe,
@@ -398,6 +400,41 @@ async function cmdSearch(flags: Record<string, string | boolean>) {
 	}
 }
 
+function cmdInstallSkills(flags: Record<string, string | boolean>) {
+	const json = hasFlag(flags, "json");
+	const report = installSkills();
+
+	if (!report.ok) {
+		exitError(report.error ?? "Failed to install skills.", json);
+	}
+
+	if (json) {
+		output(report, true);
+		return;
+	}
+
+	if (report.detected.length === 0) {
+		console.log("No supported agent installations detected.");
+	} else {
+		const detectedLabels = report.detected.map((item) => item.label).join(", ");
+		console.log(`Detected: ${detectedLabels}`);
+	}
+
+	if (report.installed.length === 0) {
+		console.log("No skills installed.");
+	} else {
+		for (const item of report.installed) {
+			console.log(`Installed ${item.label}: ${item.path}`);
+		}
+	}
+
+	if (report.skipped.length > 0) {
+		for (const item of report.skipped) {
+			console.log(`Skipped ${item.label} (${item.reason})`);
+		}
+	}
+}
+
 async function cmdSync(flags: Record<string, string | boolean>) {
 	const json = hasFlag(flags, "json");
 
@@ -602,6 +639,7 @@ Usage:
 
 Commands:
   version     Show binary version
+  install-skills  Install bundled skills into local agent directories
   context     Build & print context injection string
   write       Write to memory files
   read        Read memory files
@@ -671,6 +709,9 @@ async function main() {
 		case "search":
 			await cmdSearch(flags);
 			break;
+		case "install-skills":
+			cmdInstallSkills(flags);
+			break;
 		case "sync":
 			await cmdSync(flags);
 			break;

package/src/core.ts

@@ -399,6 +399,8 @@ let spawnFn: SpawnFn = spawn;
 let qmdAvailable = false;
 let updateTimer: ReturnType<typeof setTimeout> | null = null;
 let embedTimer: ReturnType<typeof setTimeout> | null = null;
+let skillsRootOverride: string | null = null;
+let homeDirOverride: string | null = null;
 
 /** QMD collection name — configurable per platform. */
 let QMD_COLLECTION_NAME = "agent-memory";
@@ -413,6 +415,16 @@ export function _resetExecFileForTest() {
 	execFileFn = execFile;
 }
 
+/** Override skills root directory (for testing). */
+export function _setSkillsRootForTest(dir: string | null) {
+	skillsRootOverride = dir;
+}
+
+/** Override home directory (for testing). */
+export function _setHomeDirForTest(dir: string | null) {
+	homeDirOverride = dir;
+}
+
 /** Override spawn implementation (for testing). */
 export function _setSpawnForTest(fn: SpawnFn) {
 	spawnFn = fn;
@@ -459,6 +471,39 @@ export function _clearEmbedTimer() {
 	}
 }
 
+function resolveHomeDir(): string | null {
+	if (homeDirOverride !== null) return homeDirOverride;
+	return process.env.HOME ?? process.env.USERPROFILE ?? null;
+}
+
+function findSkillsRoot(): string | null {
+	const envRoot = process.env.AGENT_MEMORY_SKILLS_ROOT;
+	if (envRoot) return envRoot;
+	if (skillsRootOverride) return skillsRootOverride;
+
+	const scanUp = (startDir: string): string | null => {
+		let dir = startDir;
+		while (true) {
+			if (fs.existsSync(path.join(dir, "skills"))) return dir;
+			const parent = path.dirname(dir);
+			if (parent === dir) return null;
+			dir = parent;
+		}
+	};
+
+	const argvPath = process.argv[1];
+	if (argvPath) {
+		const found = scanUp(path.resolve(path.dirname(argvPath)));
+		if (found) return found;
+	}
+
+	const execDir = path.dirname(process.execPath);
+	const found = scanUp(path.resolve(execDir));
+	if (found) return found;
+
+	return scanUp(path.resolve(process.cwd()));
+}
+
 /** Get the current QMD collection name. */
 export function getCollectionName(): string {
 	return QMD_COLLECTION_NAME;
@@ -669,6 +714,111 @@ export async function runQmdSync(): Promise<{ updateOk: boolean; embedOk: boolea
 	return { updateOk, embedOk };
 }
 
+export interface InstallSkillsReport {
+	ok: boolean;
+	projectDir?: string;
+	homeDir?: string;
+	detected: Array<{ label: string; homeMarker: string }>;
+	installed: Array<{ label: string; path: string }>;
+	skipped: Array<{ label: string; reason: string }>;
+	error?: string;
+}
+
+export function installSkills(): InstallSkillsReport {
+	const homeDir = resolveHomeDir();
+	if (!homeDir) {
+		return {
+			ok: false,
+			detected: [],
+			installed: [],
+			skipped: [],
+			error: "Home directory not found. Set HOME (or USERPROFILE on Windows) and retry.",
+		};
+	}
+
+	const projectDir = findSkillsRoot();
+	if (!projectDir) {
+		return {
+			ok: false,
+			homeDir,
+			detected: [],
+			installed: [],
+			skipped: [],
+			error: "Could not locate the skills directory. Ensure the package includes skills/ (reinstall if needed).",
+		};
+	}
+
+	const skillsDir = path.join(projectDir, "skills");
+	if (!fs.existsSync(skillsDir)) {
+		return {
+			ok: false,
+			projectDir,
+			homeDir,
+			detected: [],
+			installed: [],
+			skipped: [],
+			error: `Skills directory not found: ${skillsDir}`,
+		};
+	}
+	const targets = [
+		{
+			label: "Claude Code skill",
+			srcDir: path.join(skillsDir, "claude-code"),
+			destDir: path.join(homeDir, ".claude", "skills", "agent-memory"),
+			homeMarker: path.join(homeDir, ".claude"),
+		},
+		{
+			label: "Codex skill",
+			srcDir: path.join(skillsDir, "codex"),
+			destDir: path.join(homeDir, ".codex", "skills", "agent-memory"),
+			homeMarker: path.join(homeDir, ".codex"),
+		},
+		{
+			label: "Cursor skill",
+			srcDir: path.join(skillsDir, "cursor"),
+			destDir: path.join(homeDir, ".cursor", "skills", "agent-memory"),
+			homeMarker: path.join(homeDir, ".cursor"),
+		},
+		{
+			label: "Agent CLI skill",
+			srcDir: path.join(skillsDir, "agent"),
+			destDir: path.join(homeDir, ".agents", "skills", "agent-memory"),
+			homeMarker: path.join(homeDir, ".agents"),
+		},
+	];
+
+	const detected: Array<{ label: string; homeMarker: string }> = [];
+	const installed: Array<{ label: string; path: string }> = [];
+	const skipped: Array<{ label: string; reason: string }> = [];
+
+	for (const target of targets) {
+		if (!fs.existsSync(target.homeMarker)) {
+			skipped.push({ label: target.label, reason: `${target.homeMarker} not found` });
+			continue;
+		}
+		detected.push({ label: target.label, homeMarker: target.homeMarker });
+
+		const skillFile = path.join(target.srcDir, "SKILL.md");
+		if (!fs.existsSync(skillFile)) {
+			skipped.push({ label: target.label, reason: `${skillFile} not found` });
+			continue;
+		}
+
+		fs.mkdirSync(target.destDir, { recursive: true });
+		fs.copyFileSync(skillFile, path.join(target.destDir, "SKILL.md"));
+		installed.push({ label: target.label, path: path.join(target.destDir, "SKILL.md") });
+	}
+
+	return {
+		ok: true,
+		projectDir,
+		homeDir,
+		detected,
+		installed,
+		skipped,
+	};
+}
+
 export interface QmdHealthInfo {
 	totalFiles: number | null;
 	vectorsEmbedded: number | null;