myagentmemory 0.4.3 → 0.4.4

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/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.4",
+	"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"
 	],
@@ -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."

package/skills/agent/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: agent-memory
+description: Persistent memory across coding sessions — long-term facts, daily logs, scratchpad checklist, and semantic search.
+---
+
+# Agent Memory
+
+You have a persistent memory system. Use it to remember decisions, preferences, lessons learned, and context across sessions.
+
+## Important: Load context at session start
+
+At the beginning of each session, run this command to load your memory context:
+
+```bash
+agent-memory context --no-search 2>/dev/null
+```
+
+## Memory Commands
+
+All commands use the `agent-memory` CLI. Examples:
+
+### Write to memory
+
+```bash
+# Save a long-term fact, decision, or preference
+agent-memory write --target long_term --content "User prefers TypeScript with strict mode"
+
+# Overwrite MEMORY.md entirely (use with care)
+agent-memory write --target long_term --content "..." --mode overwrite
+
+# Append to today's daily log
+agent-memory write --target daily --content "Fixed auth bug in login.ts — was missing token refresh"
+```
+
+### Read memory
+
+```bash
+# Read long-term memory
+agent-memory read --target long_term
+
+# Read today's daily log
+agent-memory read --target daily
+
+# Read a specific day's log
+agent-memory read --target daily --date 2026-02-15
+
+# List all daily logs
+agent-memory read --target list
+
+# Read scratchpad
+agent-memory read --target scratchpad
+```
+
+### Manage scratchpad (checklist)
+
+```bash
+# Add an item
+agent-memory scratchpad add --text "Review PR #42"
+
+# List items
+agent-memory scratchpad list
+
+# Mark item as done (matches by substring)
+agent-memory scratchpad done --text "PR #42"
+
+# Undo a done item
+agent-memory scratchpad undo --text "PR #42"
+
+# Remove all completed items
+agent-memory scratchpad clear_done
+```
+
+### Search memory (requires qmd)
+
+```bash
+# Fast keyword search
+agent-memory search --query "database choice" --mode keyword
+
+# Semantic search (finds related concepts)
+agent-memory search --query "how do we handle auth" --mode semantic
+
+# Deep hybrid search with reranking
+agent-memory search --query "performance optimization" --mode deep --limit 10
+```
+
+### Setup and status
+
+```bash
+# Initialize memory directory and qmd collection
+agent-memory init
+
+# Show configuration and status
+agent-memory status
+```
+
+## Guidelines
+
+- When someone says "remember this" or asks you to note something, write it immediately using `agent-memory write`
+- Use `--target long_term` for durable facts: decisions, preferences, architecture choices, lessons learned
+- Use `--target daily` for session notes: what you worked on, bugs found, progress updates
+- Use the scratchpad for TODOs, follow-ups, and things to keep in mind
+- Use `#tags` (e.g. `#decision`, `#preference`, `#lesson`) and `[[links]]` (e.g. `[[auth-strategy]]`) in content to improve future search recall
+- Before starting a task, check if relevant context exists via `agent-memory search`
+- At the end of a significant work session, summarize what was done in the daily log

package/skills/cursor/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: agent-memory
+description: Persistent memory across coding sessions — long-term facts, daily logs, scratchpad checklist, and semantic search.
+---
+
+# Agent Memory
+
+You have a persistent memory system. Use it to remember decisions, preferences, lessons learned, and context across sessions.
+
+## Important: Load context at session start
+
+At the beginning of each session, run this command to load your memory context:
+
+```bash
+agent-memory context --no-search 2>/dev/null
+```
+
+## Memory Commands
+
+All commands use the `agent-memory` CLI. Examples:
+
+### Write to memory
+
+```bash
+# Save a long-term fact, decision, or preference
+agent-memory write --target long_term --content "User prefers TypeScript with strict mode"
+
+# Overwrite MEMORY.md entirely (use with care)
+agent-memory write --target long_term --content "..." --mode overwrite
+
+# Append to today's daily log
+agent-memory write --target daily --content "Fixed auth bug in login.ts — was missing token refresh"
+```
+
+### Read memory
+
+```bash
+# Read long-term memory
+agent-memory read --target long_term
+
+# Read today's daily log
+agent-memory read --target daily
+
+# Read a specific day's log
+agent-memory read --target daily --date 2026-02-15
+
+# List all daily logs
+agent-memory read --target list
+
+# Read scratchpad
+agent-memory read --target scratchpad
+```
+
+### Manage scratchpad (checklist)
+
+```bash
+# Add an item
+agent-memory scratchpad add --text "Review PR #42"
+
+# List items
+agent-memory scratchpad list
+
+# Mark item as done (matches by substring)
+agent-memory scratchpad done --text "PR #42"
+
+# Undo a done item
+agent-memory scratchpad undo --text "PR #42"
+
+# Remove all completed items
+agent-memory scratchpad clear_done
+```
+
+### Search memory (requires qmd)
+
+```bash
+# Fast keyword search
+agent-memory search --query "database choice" --mode keyword
+
+# Semantic search (finds related concepts)
+agent-memory search --query "how do we handle auth" --mode semantic
+
+# Deep hybrid search with reranking
+agent-memory search --query "performance optimization" --mode deep --limit 10
+```
+
+### Setup and status
+
+```bash
+# Initialize memory directory and qmd collection
+agent-memory init
+
+# Show configuration and status
+agent-memory status
+```
+
+## Guidelines
+
+- When someone says "remember this" or asks you to note something, write it immediately using `agent-memory write`
+- Use `--target long_term` for durable facts: decisions, preferences, architecture choices, lessons learned
+- Use `--target daily` for session notes: what you worked on, bugs found, progress updates
+- Use the scratchpad for TODOs, follow-ups, and things to keep in mind
+- Use `#tags` (e.g. `#decision`, `#preference`, `#lesson`) and `[[links]]` (e.g. `[[auth-strategy]]`) in content to improve future search recall
+- Before starting a task, check if relevant context exists via `agent-memory search`
+- At the end of a significant work session, summarize what was done in the daily log