myagentmemory 0.4.3 → 0.4.5

package/README.md

@@ -1,6 +1,6 @@
 # agent-memory
 
-Persistent memory for coding agents — [Claude Code](https://claude.ai/code) and [OpenAI Codex](https://github.com/openai/codex). Semantic search powered by [qmd](https://github.com/tobi/qmd).
+Persistent memory for coding agents — [Claude Code](https://claude.ai/code), [OpenAI Codex](https://github.com/openai/codex), Cursor, and Agent (Cursor CLI). Semantic search powered by [qmd](https://github.com/tobi/qmd).
 
 Thanks to https://github.com/skyfallsin/pi-mem for inspiration.
 
@@ -12,6 +12,9 @@ Long-term facts, daily logs, and a scratchpad checklist stored as plain markdown
 # Install the CLI globally
 npm install -g myagentmemory
 
+# If you hit SSL errors due to corporate MITM/inspection, try:
+# npm config set strict-ssl false
+
 # Or build from source
 bun run build:cli
 # => produces dist/agent-memory
@@ -19,7 +22,7 @@ bun run build:cli
 # Initialize memory directory
 agent-memory init
 
-# Install skill files for Claude Code and Codex
+# Install skill files for Claude Code, Codex, Cursor, and Agent
 bash scripts/install-skills.sh
 pwsh -File scripts/install-skills.ps1
 ```
@@ -27,8 +30,12 @@ pwsh -File scripts/install-skills.ps1
 This installs:
 - `~/.claude/skills/agent-memory/SKILL.md` — Claude Code skill
 - `~/.codex/skills/agent-memory/SKILL.md` — Codex skill
+- `~/.cursor/skills/agent-memory/SKILL.md` — Cursor skill
+- `~/.agents/skills/agent-memory/SKILL.md` — Agent CLI skill (Cursor)
 - `%USERPROFILE%\.claude\skills\agent-memory\SKILL.md` — Claude Code skill (Windows)
 - `%USERPROFILE%\.codex\skills\agent-memory\SKILL.md` — Codex skill (Windows)
+- `%USERPROFILE%\.cursor\skills\agent-memory\SKILL.md` — Cursor skill (Windows)
+- `%USERPROFILE%\.agents\skills\agent-memory\SKILL.md` — Agent CLI skill (Windows)
 
 ### Optional: Enable search with qmd
 
@@ -58,7 +65,9 @@ Without qmd, all core tools (write/read/scratchpad) work normally. Only `memory_
   ┌──────────┐   ┌──────────────┐
   │ src/     │   │ skills/      │
   │ cli.ts   │   │ ├─ claude-code/SKILL.md
-  │          │   │ └─ codex/SKILL.md
+  │          │   │ ├─ codex/SKILL.md
+  │          │   │ ├─ cursor/SKILL.md
+  │          │   │ └─ agent/SKILL.md
   └──────────┘   └──────────────┘
    CLI binary     instruction files
    `agent-memory` that invoke CLI
@@ -116,7 +125,7 @@ Before every agent turn, the following are injected into the system prompt (in p
 
 Total injection is capped at 16K chars. When qmd is unavailable, step 3 is skipped and the rest works as before.
 
-For Claude Code, context is injected via the `!`agent-memory context`` syntax in the SKILL.md. For Codex, the agent runs `agent-memory context` at session start.
+For Claude Code, context is injected via the `!`agent-memory context`` syntax in the SKILL.md. For Codex, Cursor, and Agent, the agent runs `agent-memory context` at session start.
 
 ### Selective injection
 

package/dist/cli.d.ts

@@ -3,6 +3,7 @@
  * agent-memory CLI
  *
  * Subcommands:
+ *   version    — Print binary version
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files

package/dist/cli.js

@@ -3,6 +3,7 @@
  * agent-memory CLI
  *
  * Subcommands:
+ *   version    — Print binary version
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files
@@ -16,7 +17,8 @@
  *   --json         Machine-readable JSON output
  */
 import * as fs from "node:fs";
-import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, ensureDirs, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdResultPath, getQmdResultText, getScratchpadFile, nowTimestamp, parseScratchpad, readFileSafe, runQmdSearch, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, todayStr, } from "./core.js";
+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";
 function parseArgs(argv) {
     const flags = {};
     const positional = [];
@@ -319,18 +321,60 @@ async function cmdSearch(flags) {
         exitError(`Search failed: ${err instanceof Error ? err.message : String(err)}`, json);
     }
 }
+async function cmdSync(flags) {
+    const json = hasFlag(flags, "json");
+    ensureDirs();
+    const qmdFound = await ensureQmdAvailableForSync();
+    if (!qmdFound) {
+        exitError("qmd is not installed. Install: bun install -g https://github.com/tobi/qmd", json);
+    }
+    const collName = getCollectionName();
+    const hasCollection = await checkCollection(collName);
+    if (!hasCollection) {
+        exitError(`qmd collection '${collName}' not found. Run: agent-memory init`, json);
+    }
+    const result = await runQmdSync();
+    if (json) {
+        output({ ok: result.updateOk && result.embedOk, updateOk: result.updateOk, embedOk: result.embedOk }, true);
+    }
+    else {
+        if (result.updateOk) {
+            console.log("qmd update: ok");
+        }
+        else {
+            console.log("qmd update: failed");
+        }
+        if (result.embedOk) {
+            console.log("qmd embed: ok");
+        }
+        else {
+            console.log("qmd embed: failed");
+        }
+        if (result.updateOk && result.embedOk) {
+            console.log("\nIndex fully synced.");
+        }
+    }
+}
 async function cmdInit(flags) {
     const json = hasFlag(flags, "json");
     ensureDirs();
     const dir = getMemoryDir();
     const qmdFound = await detectQmd();
     let collectionCreated = false;
+    let indexUpdated = false;
+    let embedStarted = false;
     if (qmdFound) {
         const collName = getCollectionName();
         const hasCollection = await checkCollection(collName);
         if (!hasCollection) {
             collectionCreated = await setupQmdCollection();
         }
+        // Run initial index update + start background embed
+        await ensureQmdAvailableForUpdate();
+        await runQmdUpdateNow();
+        indexUpdated = true;
+        const child = runQmdEmbedDetached();
+        embedStarted = child !== null;
     }
     if (json) {
         output({
@@ -338,6 +382,8 @@ async function cmdInit(flags) {
             directory: dir,
             qmd: qmdFound,
             collectionCreated,
+            indexUpdated,
+            embedStarted,
         }, true);
     }
     else {
@@ -350,6 +396,12 @@ async function cmdInit(flags) {
             else {
                 console.log(`  qmd collection '${getCollectionName()}' already exists.`);
             }
+            if (indexUpdated) {
+                console.log(`  Index updated.`);
+            }
+            if (embedStarted) {
+                console.log(`  Embedding started in background.`);
+            }
         }
         else {
             console.log(`  qmd not found — search features unavailable.`);
@@ -375,9 +427,15 @@ async function cmdStatus(flags) {
     }
     const qmdFound = await detectQmd();
     let hasCollection = false;
+    let health = null;
     if (qmdFound) {
         hasCollection = await checkCollection();
+        if (hasCollection) {
+            await ensureQmdAvailableForSync();
+            health = await getQmdHealth();
+        }
     }
+    const embedMode = getQmdEmbedMode();
     if (json) {
         output({
             directory: dir,
@@ -395,7 +453,9 @@ async function cmdStatus(flags) {
             qmd: {
                 available: qmdFound,
                 collection: hasCollection ? getCollectionName() : null,
+                health,
             },
+            embedMode,
         }, true);
     }
     else {
@@ -421,6 +481,19 @@ async function cmdStatus(flags) {
         if (qmdFound) {
             console.log(`qmd: available`);
             console.log(`Collection '${getCollectionName()}': ${hasCollection ? "configured" : "not configured — run: agent-memory init"}`);
+            console.log(`Embed mode: ${embedMode}`);
+            if (health) {
+                if (health.totalFiles !== null)
+                    console.log(`Files indexed: ${health.totalFiles}`);
+                if (health.vectorsEmbedded !== null)
+                    console.log(`Vectors embedded: ${health.vectorsEmbedded}`);
+                if (health.pendingEmbed !== null && health.pendingEmbed > 0) {
+                    console.log(`Pending embeds: ${health.pendingEmbed}`);
+                    console.log(`  run: agent-memory sync`);
+                }
+                if (health.lastUpdated)
+                    console.log(`Last updated: ${health.lastUpdated}`);
+            }
         }
         else {
             console.log("qmd: not installed");
@@ -437,11 +510,13 @@ Usage:
   agent-memory <command> [options]
 
 Commands:
+  version     Show binary version
   context     Build & print context injection string
   write       Write to memory files
   read        Read memory files
   scratchpad  Manage checklist items
   search      Search across memory files (requires qmd)
+  sync        Re-index and embed all files (requires qmd)
   init        Initialize memory directory and qmd collection
   status      Show configuration and status
 
@@ -461,6 +536,7 @@ Examples:
   agent-memory scratchpad done --text "PR #42"
   agent-memory search --query "database choice" --mode keyword
   agent-memory context --no-search
+  agent-memory sync
   agent-memory status --json`);
 }
 // ---------------------------------------------------------------------------
@@ -474,6 +550,10 @@ async function main() {
     if (dir) {
         _setBaseDir(dir);
     }
+    if (command === "version" || hasFlag(flags, "version")) {
+        output(json ? { version: VERSION } : VERSION, json);
+        return;
+    }
     if (!command || command === "help" || hasFlag(flags, "help")) {
         printUsage();
         return;
@@ -494,6 +574,9 @@ async function main() {
         case "search":
             await cmdSearch(flags);
             break;
+        case "sync":
+            await cmdSync(flags);
+            break;
         case "init":
             await cmdInit(flags);
             break;

package/dist/core.d.ts

@@ -4,7 +4,8 @@
  * Core logic for agent-memory CLI and skills.
  * Zero pi peer dependencies — only node:fs, node:path, node:child_process.
  */
-import { execFile } from "node:child_process";
+import type { ChildProcess } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 /** Override base directory (for testing or platform-specific defaults). */
 export declare function _setBaseDir(baseDir: string): void;
 /** Reset to default paths. */
@@ -59,10 +60,15 @@ export declare function parseScratchpad(content: string): ScratchpadItem[];
 export declare function serializeScratchpad(items: ScratchpadItem[]): string;
 export declare function buildMemoryContext(searchResults?: string): string;
 type ExecFileFn = typeof execFile;
+type SpawnFn = typeof spawn;
 /** Override execFile implementation (for testing). */
 export declare function _setExecFileForTest(fn: ExecFileFn): void;
 /** Reset execFile implementation (for testing). */
 export declare function _resetExecFileForTest(): void;
+/** Override spawn implementation (for testing). */
+export declare function _setSpawnForTest(fn: SpawnFn): void;
+/** Reset spawn implementation (for testing). */
+export declare function _resetSpawnForTest(): void;
 /** Set qmd availability flag (for testing). */
 export declare function _setQmdAvailable(value: boolean): void;
 /** Get current qmd availability flag. */
@@ -71,6 +77,10 @@ export declare function _getQmdAvailable(): boolean;
 export declare function _getUpdateTimer(): ReturnType<typeof setTimeout> | null;
 /** Clear the update timer (for testing). */
 export declare function _clearUpdateTimer(): void;
+/** Get current embed timer (for testing). */
+export declare function _getEmbedTimer(): ReturnType<typeof setTimeout> | null;
+/** Clear the embed timer (for testing). */
+export declare function _clearEmbedTimer(): void;
 /** Get the current QMD collection name. */
 export declare function getCollectionName(): string;
 /** Set the QMD collection name (for platform-specific overrides). */
@@ -83,8 +93,28 @@ export declare function detectQmd(): Promise<boolean>;
 export declare function checkCollection(name?: string): Promise<boolean>;
 export declare function getQmdUpdateMode(): "background" | "manual" | "off";
 export declare function ensureQmdAvailableForUpdate(): Promise<boolean>;
+export declare function getQmdEmbedMode(): "background" | "manual" | "off";
+export declare function runQmdEmbedDetached(): ChildProcess | null;
+export declare function scheduleQmdEmbed(): void;
 export declare function scheduleQmdUpdate(): void;
 export declare function runQmdUpdateNow(): Promise<void>;
+export declare function runQmdEmbedNow(): Promise<boolean>;
+export declare function ensureQmdAvailableForSync(): Promise<boolean>;
+export declare function runQmdSync(): Promise<{
+    updateOk: boolean;
+    embedOk: boolean;
+}>;
+export interface QmdHealthInfo {
+    totalFiles: number | null;
+    vectorsEmbedded: number | null;
+    pendingEmbed: number | null;
+    lastUpdated: string | null;
+    collectionFiles: number | null;
+    collectionUpdated: string | null;
+    embedMode: string;
+}
+export declare function parseQmdStatus(stdout: string, collectionName: string): QmdHealthInfo;
+export declare function getQmdHealth(): Promise<QmdHealthInfo | null>;
 /** Search for memories relevant to the user's prompt. Returns formatted markdown or empty string on error. */
 export declare function searchRelevantMemories(prompt: string): Promise<string>;
 export interface QmdSearchResult {

package/dist/core.js

@@ -4,7 +4,7 @@
  * Core logic for agent-memory CLI and skills.
  * Zero pi peer dependencies — only node:fs, node:path, node:child_process.
  */
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 // ---------------------------------------------------------------------------
@@ -280,8 +280,10 @@ export function buildMemoryContext(searchResults) {
     return context;
 }
 let execFileFn = execFile;
+let spawnFn = spawn;
 let qmdAvailable = false;
 let updateTimer = null;
+let embedTimer = null;
 /** QMD collection name — configurable per platform. */
 let QMD_COLLECTION_NAME = "agent-memory";
 /** Override execFile implementation (for testing). */
@@ -292,6 +294,14 @@ export function _setExecFileForTest(fn) {
 export function _resetExecFileForTest() {
     execFileFn = execFile;
 }
+/** Override spawn implementation (for testing). */
+export function _setSpawnForTest(fn) {
+    spawnFn = fn;
+}
+/** Reset spawn implementation (for testing). */
+export function _resetSpawnForTest() {
+    spawnFn = spawn;
+}
 /** Set qmd availability flag (for testing). */
 export function _setQmdAvailable(value) {
     qmdAvailable = value;
@@ -311,6 +321,17 @@ export function _clearUpdateTimer() {
         updateTimer = null;
     }
 }
+/** Get current embed timer (for testing). */
+export function _getEmbedTimer() {
+    return embedTimer;
+}
+/** Clear the embed timer (for testing). */
+export function _clearEmbedTimer() {
+    if (embedTimer) {
+        clearTimeout(embedTimer);
+        embedTimer = null;
+    }
+}
 /** Get the current QMD collection name. */
 export function getCollectionName() {
     return QMD_COLLECTION_NAME;
@@ -425,6 +446,39 @@ export async function ensureQmdAvailableForUpdate() {
     qmdAvailable = await detectQmd();
     return qmdAvailable;
 }
+export function getQmdEmbedMode() {
+    const mode = (process.env.AGENT_MEMORY_QMD_EMBED ?? "background").toLowerCase();
+    if (mode === "manual" || mode === "off" || mode === "background") {
+        return mode;
+    }
+    return "background";
+}
+export function runQmdEmbedDetached() {
+    if (!qmdAvailable)
+        return null;
+    const child = spawnFn("qmd", ["embed"], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    return child;
+}
+export function scheduleQmdEmbed() {
+    if (getQmdEmbedMode() !== "background")
+        return;
+    if (!qmdAvailable)
+        return;
+    if (embedTimer)
+        clearTimeout(embedTimer);
+    embedTimer = setTimeout(() => {
+        embedTimer = null;
+        runQmdEmbedDetached();
+    }, 5_000);
+    // Don't prevent process exit while waiting to embed
+    if (embedTimer && typeof embedTimer === "object" && "unref" in embedTimer) {
+        embedTimer.unref();
+    }
+}
 export function scheduleQmdUpdate() {
     if (getQmdUpdateMode() !== "background")
         return;
@@ -434,7 +488,9 @@ export function scheduleQmdUpdate() {
         clearTimeout(updateTimer);
     updateTimer = setTimeout(() => {
         updateTimer = null;
-        execFileFn("qmd", ["update"], { timeout: 30_000 }, () => { });
+        execFileFn("qmd", ["update"], { timeout: 30_000 }, () => {
+            scheduleQmdEmbed();
+        });
     }, 500);
 }
 export async function runQmdUpdateNow() {
@@ -446,6 +502,89 @@ export async function runQmdUpdateNow() {
         execFileFn("qmd", ["update"], { timeout: 30_000 }, () => resolve());
     });
 }
+export async function runQmdEmbedNow() {
+    if (!qmdAvailable)
+        return false;
+    return new Promise((resolve) => {
+        execFileFn("qmd", ["embed"], { timeout: 120_000 }, (err) => {
+            resolve(!err);
+        });
+    });
+}
+export async function ensureQmdAvailableForSync() {
+    if (qmdAvailable)
+        return true;
+    qmdAvailable = await detectQmd();
+    return qmdAvailable;
+}
+export async function runQmdSync() {
+    if (!qmdAvailable)
+        return { updateOk: false, embedOk: false };
+    const updateOk = await new Promise((resolve) => {
+        execFileFn("qmd", ["update"], { timeout: 30_000 }, (err) => {
+            resolve(!err);
+        });
+    });
+    const embedOk = await runQmdEmbedNow();
+    return { updateOk, embedOk };
+}
+export function parseQmdStatus(stdout, collectionName) {
+    const result = {
+        totalFiles: null,
+        vectorsEmbedded: null,
+        pendingEmbed: null,
+        lastUpdated: null,
+        collectionFiles: null,
+        collectionUpdated: null,
+        embedMode: getQmdEmbedMode(),
+    };
+    if (!stdout.trim())
+        return result;
+    // Total files across all collections
+    const totalFilesMatch = stdout.match(/(\d+)\s+(?:total\s+)?files?/i);
+    if (totalFilesMatch) {
+        result.totalFiles = Number.parseInt(totalFilesMatch[1], 10);
+    }
+    // Vectors / embeddings
+    const vectorsMatch = stdout.match(/(\d+)\s+(?:vectors?|embeddings?)/i);
+    if (vectorsMatch) {
+        result.vectorsEmbedded = Number.parseInt(vectorsMatch[1], 10);
+    }
+    // Pending embed
+    const pendingMatch = stdout.match(/(\d+)\s+pending/i);
+    if (pendingMatch) {
+        result.pendingEmbed = Number.parseInt(pendingMatch[1], 10);
+    }
+    // If we have totalFiles and vectorsEmbedded but no explicit pending, infer it
+    if (result.pendingEmbed === null && result.totalFiles !== null && result.vectorsEmbedded !== null) {
+        result.pendingEmbed = Math.max(0, result.totalFiles - result.vectorsEmbedded);
+    }
+    // Last updated timestamp
+    const updatedMatch = stdout.match(/(?:last\s+)?updated:?\s+(\d{4}-\d{2}-\d{2}[\sT]\d{2}:\d{2}[:\d]*)/i);
+    if (updatedMatch) {
+        result.lastUpdated = updatedMatch[1];
+    }
+    // Collection-specific info — look for collection name section
+    const collectionPattern = new RegExp(`${collectionName}[:\\s]*(?:.*?)(\\d+)\\s+files?`, "i");
+    const collMatch = stdout.match(collectionPattern);
+    if (collMatch) {
+        result.collectionFiles = Number.parseInt(collMatch[1], 10);
+    }
+    return result;
+}
+export async function getQmdHealth() {
+    if (!qmdAvailable)
+        return null;
+    return new Promise((resolve) => {
+        execFileFn("qmd", ["status"], { timeout: 10_000 }, (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(parseQmdStatus(stdout ?? "", QMD_COLLECTION_NAME));
+        });
+    });
+}
 /** Search for memories relevant to the user's prompt. Returns formatted markdown or empty string on error. */
 export async function searchRelevantMemories(prompt) {
     if (!qmdAvailable || !prompt.trim())

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "myagentmemory",
-	"version": "0.4.3",
-	"description": "Persistent memory for coding agents (Claude Code, Codex) with qmd-powered semantic search across daily logs, long-term memory, and scratchpad",
+	"version": "0.4.5",
+	"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",
 	"exports": {
@@ -22,6 +22,8 @@
 		"daily-log",
 		"claude-code",
 		"codex",
+		"cursor",
+		"agent",
 		"agent-memory",
 		"coding-agent"
 	],
@@ -50,7 +52,7 @@
 		"postinstall": "node scripts/postinstall.cjs",
 		"build": "tsc -p tsconfig.json --noEmit",
 		"build:lib": "tsc -p tsconfig.build.json",
-		"build:cli": "bun build src/cli.ts --compile --outfile dist/agent-memory",
+		"build:cli": "bun build src/cli.ts --compile --outfile dist/agent-memory --define __VERSION__=\"'$(node -p \"require('./package.json').version\")'\"",
 		"prepack": "npm run build:lib && bun run build:cli",
 		"lint": "biome check .",
 		"test": "bun test test/unit.test.ts",
@@ -60,6 +62,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.4.0",
+		"@types/node": "^25.3.0",
 		"tsx": "^4.0.0",
 		"typescript": "^5.9.3"
 	},

package/scripts/install-skills.ps1

@@ -3,28 +3,34 @@ $ErrorActionPreference = "Stop"
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $ProjectDir = Split-Path -Parent $ScriptDir
 
-# Claude Code skill
-$ClaudeSkillDir = Join-Path $env:USERPROFILE ".claude\\skills\\agent-memory"
-$ClaudeSkillSrc = Join-Path $ProjectDir "skills\\claude-code\\SKILL.md"
-if (Test-Path $ClaudeSkillSrc) {
-	New-Item -ItemType Directory -Force -Path $ClaudeSkillDir | Out-Null
-	Copy-Item -Force $ClaudeSkillSrc (Join-Path $ClaudeSkillDir "SKILL.md")
-	Write-Host "Installed Claude Code skill: $ClaudeSkillDir\\SKILL.md"
-} else {
-	Write-Host "Skipping Claude Code skill (skills\\claude-code\\SKILL.md not found)"
-}
+function Install-Skill {
+	param(
+		[string]$Label,
+		[string]$SrcDir,
+		[string]$DestDir,
+		[string]$HomeMarker
+	)
 
-# Codex skill
-$CodexSkillDir = Join-Path $env:USERPROFILE ".codex\\skills\\agent-memory"
-$CodexSkillSrc = Join-Path $ProjectDir "skills\\codex\\SKILL.md"
-if (Test-Path $CodexSkillSrc) {
-	New-Item -ItemType Directory -Force -Path $CodexSkillDir | Out-Null
-	Copy-Item -Force $CodexSkillSrc (Join-Path $CodexSkillDir "SKILL.md")
-	Write-Host "Installed Codex skill: $CodexSkillDir\\SKILL.md"
-} else {
-	Write-Host "Skipping Codex skill (skills\\codex\\SKILL.md not found)"
+	if (-not (Test-Path $HomeMarker)) {
+		Write-Host "Skipping $Label ($HomeMarker not found)"
+		return
+	}
+
+	$SkillSrc = Join-Path $SrcDir "SKILL.md"
+	if (Test-Path $SkillSrc) {
+		New-Item -ItemType Directory -Force -Path $DestDir | Out-Null
+		Copy-Item -Force $SkillSrc (Join-Path $DestDir "SKILL.md")
+		Write-Host "Installed $Label: $DestDir\\SKILL.md"
+	} else {
+		Write-Host "Skipping $Label ($SkillSrc not found)"
+	}
 }
 
+Install-Skill -Label "Claude Code skill" -SrcDir (Join-Path $ProjectDir "skills\\claude-code") -DestDir (Join-Path $env:USERPROFILE ".claude\\skills\\agent-memory") -HomeMarker (Join-Path $env:USERPROFILE ".claude")
+Install-Skill -Label "Codex skill" -SrcDir (Join-Path $ProjectDir "skills\\codex") -DestDir (Join-Path $env:USERPROFILE ".codex\\skills\\agent-memory") -HomeMarker (Join-Path $env:USERPROFILE ".codex")
+Install-Skill -Label "Cursor skill" -SrcDir (Join-Path $ProjectDir "skills\\cursor") -DestDir (Join-Path $env:USERPROFILE ".cursor\\skills\\agent-memory") -HomeMarker (Join-Path $env:USERPROFILE ".cursor")
+Install-Skill -Label "Agent CLI skill" -SrcDir (Join-Path $ProjectDir "skills\\agent") -DestDir (Join-Path $env:USERPROFILE ".agents\\skills\\agent-memory") -HomeMarker (Join-Path $env:USERPROFILE ".agents")
+
 Write-Host ""
 Write-Host "Done."
 Write-Host ""

package/scripts/install-skills.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Install agent-memory skills for Claude Code and Codex CLI.
+# Install agent-memory skills for Claude Code, Codex, Cursor, and Agent CLI.
 # Usage: bash scripts/install-skills.sh
 
 set -euo pipefail
@@ -7,25 +7,30 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
 
-# Claude Code skill
-CLAUDE_SKILL_DIR="$HOME/.claude/skills/agent-memory"
-if [ -d "$PROJECT_DIR/skills/claude-code" ]; then
-  mkdir -p "$CLAUDE_SKILL_DIR"
-  cp "$PROJECT_DIR/skills/claude-code/SKILL.md" "$CLAUDE_SKILL_DIR/SKILL.md"
-  echo "Installed Claude Code skill: $CLAUDE_SKILL_DIR/SKILL.md"
-else
-  echo "Skipping Claude Code skill (skills/claude-code/ not found)"
-fi
+install_skill() {
+  local label="$1"
+  local src_dir="$2"
+  local dest_dir="$3"
+  local home_marker="$4"
 
-# Codex skill
-CODEX_SKILL_DIR="$HOME/.codex/skills/agent-memory"
-if [ -d "$PROJECT_DIR/skills/codex" ]; then
-  mkdir -p "$CODEX_SKILL_DIR"
-  cp "$PROJECT_DIR/skills/codex/SKILL.md" "$CODEX_SKILL_DIR/SKILL.md"
-  echo "Installed Codex skill: $CODEX_SKILL_DIR/SKILL.md"
-else
-  echo "Skipping Codex skill (skills/codex/ not found)"
-fi
+  if [ ! -d "$home_marker" ]; then
+    echo "Skipping $label ($home_marker not found)"
+    return
+  fi
+
+  if [ -d "$src_dir" ]; then
+    mkdir -p "$dest_dir"
+    cp "$src_dir/SKILL.md" "$dest_dir/SKILL.md"
+    echo "Installed $label: $dest_dir/SKILL.md"
+  else
+    echo "Skipping $label ($src_dir not found)"
+  fi
+}
+
+install_skill "Claude Code skill" "$PROJECT_DIR/skills/claude-code" "$HOME/.claude/skills/agent-memory" "$HOME/.claude"
+install_skill "Codex skill" "$PROJECT_DIR/skills/codex" "$HOME/.codex/skills/agent-memory" "$HOME/.codex"
+install_skill "Cursor skill" "$PROJECT_DIR/skills/cursor" "$HOME/.cursor/skills/agent-memory" "$HOME/.cursor"
+install_skill "Agent CLI skill" "$PROJECT_DIR/skills/agent" "$HOME/.agents/skills/agent-memory" "$HOME/.agents"
 
 echo ""
 echo "Done."