myagentmemory 0.4.3

package/package.json

@@ -0,0 +1,70 @@
+{
+	"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",
+	"main": "./dist/core.js",
+	"types": "./dist/core.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/core.d.ts",
+			"default": "./dist/core.js"
+		}
+	},
+	"bin": {
+		"agent-memory": "./dist/agent-memory"
+	},
+	"type": "module",
+	"keywords": [
+		"memory",
+		"search",
+		"qmd",
+		"scratchpad",
+		"daily-log",
+		"claude-code",
+		"codex",
+		"agent-memory",
+		"coding-agent"
+	],
+	"author": "jayzeng",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/jayzeng/agent-memory.git"
+	},
+	"bugs": {
+		"url": "https://github.com/jayzeng/agent-memory/issues"
+	},
+	"homepage": "https://github.com/jayzeng/agent-memory#readme",
+	"files": [
+		"src",
+		"skills",
+		"scripts",
+		"dist",
+		"README.md",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"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",
+		"prepack": "npm run build:lib && bun run build:cli",
+		"lint": "biome check .",
+		"test": "bun test test/unit.test.ts",
+		"test:unit": "bun test test/unit.test.ts",
+		"test:cli": "bun test test/cli.test.ts",
+		"install-skills": "bash scripts/install-skills.sh"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.0",
+		"tsx": "^4.0.0",
+		"typescript": "^5.9.3"
+	},
+	"overrides": {
+		"rimraf": "^6.1.3",
+		"glob": "^13.0.3"
+	}
+}

package/scripts/install-skills.ps1

@@ -0,0 +1,48 @@
+$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)"
+}
+
+# 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)"
+}
+
+Write-Host ""
+Write-Host "Done."
+Write-Host ""
+
+$BinExe = Join-Path $ProjectDir "dist\\agent-memory.exe"
+$Bin = Join-Path $ProjectDir "dist\\agent-memory"
+if (Test-Path $BinExe) {
+	Write-Host "Add this directory to your PATH:"
+	Write-Host "  $(Join-Path $ProjectDir 'dist')"
+} elseif (Test-Path $Bin) {
+	Write-Host "Add this directory to your PATH:"
+	Write-Host "  $(Join-Path $ProjectDir 'dist')"
+} else {
+	Write-Host "Build the CLI binary first:"
+	Write-Host "  bun run build:cli"
+	Write-Host "Then add this directory to your PATH:"
+	Write-Host "  $(Join-Path $ProjectDir 'dist')"
+}
+
+Write-Host ""
+Write-Host "Initialize memory: agent-memory init"

package/scripts/install-skills.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Install agent-memory skills for Claude Code and Codex CLI.
+# Usage: bash scripts/install-skills.sh
+
+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
+
+# 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
+
+echo ""
+echo "Done."
+echo ""
+AGENT_MEMORY_BIN="$PROJECT_DIR/dist/agent-memory"
+if [ -x "$AGENT_MEMORY_BIN" ]; then
+  if [ -d "$HOME/.local/bin" ]; then
+    if ln -sf "$AGENT_MEMORY_BIN" "$HOME/.local/bin/agent-memory" 2>/dev/null; then
+      echo "Linked agent-memory into: $HOME/.local/bin/agent-memory"
+      echo "Ensure $HOME/.local/bin is on your PATH."
+    else
+      echo "Could not link to $HOME/.local/bin (permissions)."
+      echo "Add this to your PATH instead:"
+      echo "  $AGENT_MEMORY_BIN"
+    fi
+  else
+    echo "Make sure 'agent-memory' is on your PATH:"
+    echo "  $AGENT_MEMORY_BIN"
+  fi
+else
+  echo "Build the CLI binary first:"
+  echo "  bun run build:cli"
+  echo "Then add it to your PATH:"
+  echo "  $AGENT_MEMORY_BIN"
+fi
+echo ""
+echo "Initialize memory: agent-memory init"

package/scripts/postinstall.cjs

@@ -0,0 +1,44 @@
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+function hasQmd() {
+	const result = spawnSync("qmd", ["status"], {
+		stdio: "ignore",
+		shell: process.platform === "win32",
+	});
+	return result.status === 0;
+}
+
+function memoryDir() {
+	const home = process.env.HOME ?? process.env.USERPROFILE ?? "~";
+	return path.join(home, ".agent-memory");
+}
+
+function configureGitHooks() {
+	const result = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], {
+		stdio: "ignore",
+		shell: process.platform === "win32",
+	});
+
+	if (result.status !== 0) {
+		return;
+	}
+
+	spawnSync("git", ["config", "core.hooksPath", ".githooks"], {
+		stdio: "ignore",
+		shell: process.platform === "win32",
+	});
+}
+
+configureGitHooks();
+
+if (!hasQmd()) {
+	const dir = memoryDir();
+	console.log("\nagent-memory: qmd not found (required for `memory_search`).\n");
+	console.log("Install qmd (requires Bun):");
+	console.log("  bun install -g https://github.com/tobi/qmd");
+	console.log("  # ensure ~/.bun/bin is in your PATH\n");
+	console.log("Then set up the collection (one-time):");
+	console.log(`  qmd collection add ${dir} --name agent-memory`);
+	console.log("  qmd embed\n");
+}

package/skills/claude-code/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: agent-memory
+description: Persistent memory across coding sessions — long-term facts, daily logs, scratchpad checklist, and semantic search.
+allowed-tools: Bash(agent-memory *)
+---
+
+# Agent Memory
+
+You have a persistent memory system. Use it to remember decisions, preferences, lessons learned, and context across sessions.
+
+## Current Memory Context
+
+!`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/codex/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