myagentmemory 0.5.2 → 0.5.3

package/scripts/install-skills.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Install (or uninstall) agent-memory skills for Claude Code, Codex, Cursor, and Agent CLI.
+# Install (or uninstall) agent-memory skills for Claude Code, Codex, Cursor, Agent CLI, and Qoder.
 # Usage: bash scripts/install-skills.sh [--uninstall]
 
 set -euo pipefail
@@ -63,12 +63,14 @@ SKILL_DIRS=(
   "$HOME/.codex/skills/agent-memory"
   "$HOME/.cursor/skills/agent-memory"
   "$HOME/.agents/skills/agent-memory"
+  "$HOME/.qoder/skills/agent-memory"
 )
 SKILL_LABELS=(
   "Claude Code skill"
   "Codex skill"
   "Cursor skill"
   "Agent CLI skill"
+  "Qoder skill"
 )
 
 if $UNINSTALL; then
@@ -84,6 +86,7 @@ else
   install_skill "Codex skill" "$PROJECT_DIR/skills/codex" "$HOME/.codex/skills/agent-memory" "$HOME/.codex" '[ -f "$HOME/.codex/config.toml" ] || command_exists 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"
+  install_skill "Qoder skill" "$PROJECT_DIR/skills/qoder" "$HOME/.qoder/skills/agent-memory" "$HOME/.qoder" '[ -f "$HOME/.qoder/settings.json" ] || [ -f "$HOME/.qoder/settings.local.json" ] || command_exists qoder'
   echo ""
   echo "Done."
 fi

package/skills/agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-memory
-description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and semantic search.
+description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and keyword/semantic search, plus recall of past chat sessions. Use whenever the user says "remember", "recall", or asks to look up/search memory.
 ---
 
 # Agent Memory

package/skills/claude-code/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-memory
-description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and semantic search.
+description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and keyword/semantic search, plus recall of past chat sessions. Use whenever the user says "remember", "recall", or asks to look up/search memory.
 allowed-tools: Bash(agent-memory *)
 ---
 

package/skills/codex/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-memory
-description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and semantic search.
+description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and keyword/semantic search, plus recall of past chat sessions. Use whenever the user says "remember", "recall", or asks to look up/search memory.
 ---
 
 # Agent Memory

package/skills/cursor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-memory
-description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and semantic search.
+description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and keyword/semantic search, plus recall of past chat sessions. Use whenever the user says "remember", "recall", or asks to look up/search memory.
 ---
 
 # Agent Memory

package/skills/qoder/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: agent-memory
+description: Persistent memory across coding sessions — long-term facts, daily logs, topic notes, scratchpad checklist, and semantic search.
+---
+
+# Agent Memory
+
+You have a persistent memory system. Use it **proactively** — don't wait to be asked.
+
+## Current Memory Context
+
+Run this to load memory context at session start:
+
+```bash
+agent-memory context --no-search 2>/dev/null
+```
+
+## Session Lifecycle
+
+### On session start
+1. Run `agent-memory context` to load memory — especially check **open scratchpad items** (pick up where you left off)
+2. If the user's task relates to prior work, search for relevant memories:
+   ```bash
+   agent-memory search --query "<topic>" --mode keyword
+   ```
+
+### On session end (after significant work)
+1. Log what was accomplished in the daily log
+2. Mark completed scratchpad items as done; add new follow-ups
+3. Only write to long-term memory if you discovered a **durable fact** that doesn't already exist there
+
+## Where to Write — Decision Guide
+
+**Default to daily. Long-term is rare.**
+
+| What happened | Write to | Why |
+|---|---|---|
+| Made progress, fixed a bug, investigated something | `daily` | Session-specific — searchable later via qmd |
+| Tracking a topic or event across days | `topic` | Builds a per-topic file with backlinks to daily logs |
+| User said "remember this" about a preference or decision | `long_term` | Durable fact, needs to be in every session's context |
+| Discovered a recurring pattern (3rd time seeing it) | `long_term` | Graduated from daily observations to established fact |
+| Found a gotcha, workaround, or non-obvious behavior | `daily` first | If it keeps coming up, *then* promote to long-term |
+| TODO or follow-up for any task (persistent todo) | `scratchpad` | Persistent, cross-session task tracking |
+
+**MEMORY.md is a curated wiki, not a log.** It should stay under ~50 lines of high-signal content. If you're appending to it frequently, you're probably writing to the wrong target.
+
+## Memory Commands
+
+### Write to daily log (default — no --target needed)
+
+```bash
+# Session notes, progress, bugs found, decisions made
+agent-memory write --content "Fixed auth bug in login.ts — token refresh was missing"
+agent-memory write --content "Investigated slow queries — N+1 in getUserOrders, added .include(:orders)"
+```
+
+### Write to long-term memory (rare, curated)
+
+```bash
+# Only for durable facts that belong in every session's context
+agent-memory write --target long_term --content "Project uses Drizzle ORM with PostgreSQL. Migrations in db/migrations/. #architecture"
+
+# Overwrite MEMORY.md entirely (for curation — rewrite, don't append)
+agent-memory write --target long_term --content "..." --mode overwrite
+```
+
+When writing to long-term, prefer **overwrite mode** to curate the whole file rather than blindly appending. Read it first, then rewrite with the new fact incorporated.
+
+### Write to a topic/event file
+
+```bash
+# Event- or theme-based log with backlinks to the daily entry
+agent-memory write --target topic --topic "auth" --content "JWT refresh rolled out to edge #auth"
+```
+
+### Read
+
+```bash
+agent-memory read --target daily             # Today's log
+agent-memory read --target daily --date 2026-02-15  # Specific day
+agent-memory read --target list              # All daily log files
+agent-memory read --target topic --topic "auth"
+agent-memory read --target topics            # All topic files
+agent-memory read --target long_term         # MEMORY.md
+agent-memory read --target scratchpad        # Scratchpad checklist
+```
+
+### Scratchpad (persistent TODOs)
+
+```bash
+agent-memory scratchpad add --text "Review PR #42"
+agent-memory scratchpad list
+agent-memory scratchpad done --text "PR #42"       # Matches by substring
+agent-memory scratchpad undo --text "PR #42"
+agent-memory scratchpad clear_done                  # Remove completed items
+```
+
+### Search — recall past work
+
+Search is how you find things written to daily logs. Use it before duplicating effort.
+
+```bash
+agent-memory search --query "database choice" --mode keyword    # Fast keyword
+agent-memory search --query "how we handle auth" --mode semantic # Finds related concepts
+agent-memory search --query "performance" --mode deep --limit 10 # Hybrid + reranking
+```
+
+If qmd is not installed, fall back to reading files directly:
+```bash
+agent-memory read --target long_term
+agent-memory read --target daily
+```
+
+### Setup
+
+```bash
+agent-memory init      # Create dirs, detect qmd, setup collection
+agent-memory sync      # Re-index and embed all files (requires qmd)
+agent-memory status    # Show config, file counts, qmd status
+```
+
+## Writing Good Entries
+
+### Daily log entries
+Describe what you did and what you learned. Include `#tags`.
+
+**Recommended tags** (use what fits, invent your own as needed):
+`#architecture` `#auth` `#bugfix` `#database` `#deploy` `#docs` `#ops` `#perf` `#refactor` `#security` `#testing` `#ui`
+
+```bash
+# Good — specific, searchable, tagged
+agent-memory write --content "Refactored auth middleware to use jose instead of jsonwebtoken. Reduced bundle by 40KB. #refactor #auth"
+
+# Bad — too vague, no tags
+agent-memory write --content "worked on auth stuff"
+```
+
+### Long-term entries
+Only facts that should appear in **every** session's context. Use `#tags` and `[[links]]`.
+
+```bash
+# Good — this belongs in every session
+agent-memory write --target long_term --content "Deploy: 'bun run deploy:prod', requires AWS_PROFILE=prod. #ops [[deploy]]"
+
+# Bad — this is a daily log entry, not a durable fact
+agent-memory write --target long_term --content "Fixed the deploy script today"
+```
+
+## Memory Hygiene
+
+- **Daily is the default** — when in doubt, write to daily (no `--target` needed)
+- **MEMORY.md is a wiki** — curate it by reading + rewriting, not by appending endlessly
+- **Keep MEMORY.md under ~50 lines** — it's injected into every session, so only high-signal facts belong there
+- **Search before writing long-term** — the fact may already exist in a daily log, searchable via qmd
+- **Promote deliberately** — if a pattern appears in daily logs 3+ times, that's when it earns a spot in MEMORY.md
+
+## Guidelines
+
+- When someone says "remember this", decide: is it a durable fact (long-term) or a session note (daily)?
+- Default to daily for almost everything (just `--content "..."` — no `--target` needed)
+- Use `--target long_term` sparingly: architecture, preferences, key commands, hard-won lessons
+- Prefer the scratchpad for any TODOs or follow-ups (persistent, cross-session tracking)
+- Use `#tags` and `[[links]]` in content to improve search recall
+- Use `agent-memory search` to recall past work before starting related tasks

package/src/cli-spec.ts

@@ -26,6 +26,7 @@ export const COMMANDS = [
 	"uninstall-skills",
 	"install-hooks",
 	"uninstall-hooks",
+	"uninstall",
 	"completion",
 	"pro",
 	"recall",
@@ -61,6 +62,8 @@ export const COMMAND_DESCRIPTIONS: Record<(typeof COMMANDS)[number], string> = {
 	"uninstall-skills": "remove core instructions from detected agents",
 	"install-hooks": "install managed context and memory-write reminder hooks",
 	"uninstall-hooks": "remove only hooks managed by agent-memory",
+	uninstall:
+		"remove hooks, skills, MCP registrations, completions, and the Pro plugin; add --data to also delete memory data",
 	completion: "install or print Bash, Zsh, Fish, or PowerShell completion",
 	pro: "install, inspect, or upgrade AgentMemory Pro",
 	recall: "recall decisions and context from prior coding sessions with Pro",
@@ -68,7 +71,7 @@ export const COMMAND_DESCRIPTIONS: Record<(typeof COMMANDS)[number], string> = {
 	dashboard: "open the private local Memory Dashboard",
 	plugin: "discover, install, update, or remove optional official plugins",
 	serve: "run as a Model Context Protocol (MCP) server over stdio",
-	upgrade: "check for and install newer agent-memory CLI and Pro plugin releases",
+	upgrade: "check for, and auto-install by default, newer agent-memory CLI and Pro plugin releases",
 	version: "print the installed agent-memory version",
 	help: "show this command overview",
 };
@@ -113,6 +116,7 @@ export const COMMAND_OPTIONS: Record<string, readonly string[]> = {
 	"uninstall-skills": [],
 	"install-hooks": ["--yes", "--all", "--only", "--mode"],
 	"uninstall-hooks": ["--only"],
+	uninstall: ["--data", "--yes"],
 	completion: ["--stdout"],
 	pro: [],
 	recall: [
@@ -129,7 +133,7 @@ export const COMMAND_OPTIONS: Record<string, readonly string[]> = {
 	learn: ["--preview"],
 	dashboard: ["--no-browser"],
 	serve: ["--mcp", "--register", "--only"],
-	upgrade: ["--check", "--refresh", "--yes", "--quiet", "--cli", "--plugin"],
+	upgrade: ["--check", "--refresh", "--yes", "--quiet", "--cli", "--plugin", "--background"],
 	version: [],
 	help: [],
 };
@@ -294,6 +298,7 @@ export const OPTION_SPECS: Record<string, CliOptionSpec> = {
 	"--agent": { description: "internal SessionStart host key", value: { label: "agent", kind: "value" } },
 	"--token": { description: "internal session-worker lease token", value: { label: "token", kind: "value" } },
 	"--uninstall": { description: "use install-skills compatibility uninstall mode" },
+	"--data": { description: "uninstall: also permanently delete the memory directory and plugin state" },
 	"--mcp": { description: "serve as an MCP server over stdio (used by Claude Code)" },
 	"--register": { description: "register the MCP server in detected supported agents and exit" },
 	"--check": { description: "upgrade: report available updates without installing" },
@@ -301,6 +306,10 @@ export const OPTION_SPECS: Record<string, CliOptionSpec> = {
 	"--quiet": { description: "upgrade: suppress non-error output (used by the passive session-start refresh)" },
 	"--cli": { description: "upgrade: limit action to the CLI binary" },
 	"--plugin": { description: "upgrade: limit action to the Pro plugin bundle" },
+	"--background": {
+		description:
+			"upgrade: non-interactive; installs only targets whose policy is 'auto' (see: agent-memory upgrade policy)",
+	},
 };
 
 export const SHELL_DESCRIPTIONS: Record<string, string> = {
@@ -339,6 +348,7 @@ const COMMAND_USAGE: Record<string, string> = {
 	"install-hooks":
 		"agent-memory install-hooks [--yes] [--all] [--only claude,codex,cursor] [--mode stable|per-turn] [--json]",
 	"uninstall-hooks": "agent-memory uninstall-hooks [--only claude,codex,cursor] [--json]",
+	uninstall: "agent-memory uninstall [--data] [--yes] [--json]",
 	completion: "agent-memory completion [bash|zsh|fish|powershell] [--stdout]",
 	pro: "agent-memory pro <install|status|upgrade> [--channel stable] [--yes]",
 	recall:
@@ -347,7 +357,8 @@ const COMMAND_USAGE: Record<string, string> = {
 	dashboard: "agent-memory dashboard [--no-browser]",
 	plugin:
 		"agent-memory plugin <list|status|install|update|uninstall|manage> [--channel stable] [--yes] [--no-browser]",
-	upgrade: "agent-memory upgrade [--check] [--yes] [--cli|--plugin] [--refresh] [--json]",
+	upgrade:
+		"agent-memory upgrade [--check] [--yes] [--cli|--plugin] [--refresh] [--json]\n  agent-memory upgrade policy [off|notify|auto] [--cli|--plugin] [--json]  (default: auto for both)",
 	version: "agent-memory version",
 	help: "agent-memory help [<command>]",
 };
@@ -386,6 +397,10 @@ const COMMAND_EXAMPLES: Record<string, string[]> = {
 	status: ["agent-memory status", "agent-memory status --json"],
 	init: ["agent-memory init", "agent-memory init --yes --skip-hooks"],
 	setup: ["agent-memory setup", "agent-memory setup --json"],
+	uninstall: [
+		"agent-memory uninstall --yes  # removes hooks, skills, MCP registrations, completions, Pro plugin",
+		"agent-memory uninstall --data --yes  # also deletes MEMORY.md, daily logs, scratchpad, topics",
+	],
 	"install-hooks": [
 		"agent-memory install-hooks",
 		"agent-memory install-hooks --yes",

package/src/completions.ts

@@ -29,6 +29,14 @@ export interface CompletionInstallResult {
 	profileUpdated: boolean;
 }
 
+export interface CompletionUninstallResult {
+	shell: CompletionShell;
+	completionPath: string;
+	removed: boolean;
+	profilePath?: string;
+	profileUpdated: boolean;
+}
+
 function words(values: readonly string[]): string {
 	return values.join(" ");
 }
@@ -460,6 +468,27 @@ function ensureProfileBlock(filePath: string, lines: string[]): boolean {
 	return true;
 }
 
+/** Reverse of {@link ensureProfileBlock}: strips the marker block, if present, from the given file. */
+function removeProfileBlock(filePath: string): boolean {
+	const start = "# >>> agent-memory completion >>>";
+	const end = "# <<< agent-memory completion <<<";
+	if (!fs.existsSync(filePath)) return false;
+	const current = fs.readFileSync(filePath, "utf8");
+	const startIndex = current.indexOf(start);
+	const endIndex = startIndex === -1 ? -1 : current.indexOf(end, startIndex);
+	if (startIndex === -1 || endIndex === -1) return false;
+	const updated = (current.slice(0, startIndex) + current.slice(endIndex + end.length)).replace(/\n{3,}/g, "\n\n");
+	if (updated === current) return false;
+	fs.writeFileSync(filePath, updated, { mode: 0o600 });
+	return true;
+}
+
+function removeCompletionFile(filePath: string): boolean {
+	if (!fs.existsSync(filePath)) return false;
+	fs.unlinkSync(filePath);
+	return true;
+}
+
 export function installCompletion(
 	shell: CompletionShell,
 	options: { homeDir?: string; platform?: NodeJS.Platform } = {},
@@ -507,3 +536,47 @@ export function installCompletion(
 	]);
 	return { shell, completionPath, profilePath, profileUpdated };
 }
+
+function uninstallShellCompletion(
+	shell: CompletionShell,
+	homeDir: string,
+	platform: NodeJS.Platform,
+): CompletionUninstallResult {
+	const completionDir = path.join(homeDir, ".config", "agent-memory", "completions");
+
+	if (shell === "fish") {
+		const completionPath = path.join(homeDir, ".config", "fish", "completions", "agent-memory.fish");
+		return { shell, completionPath, removed: removeCompletionFile(completionPath), profileUpdated: false };
+	}
+
+	const extension = shell === "powershell" ? "ps1" : shell;
+	const completionPath = path.join(completionDir, `agent-memory.${extension}`);
+	const removed = removeCompletionFile(completionPath);
+
+	if (shell === "bash") {
+		const profilePath = path.join(homeDir, ".bashrc");
+		return { shell, completionPath, removed, profilePath, profileUpdated: removeProfileBlock(profilePath) };
+	}
+
+	if (shell === "zsh") {
+		const profilePath = path.join(homeDir, ".zshrc");
+		return { shell, completionPath, removed, profilePath, profileUpdated: removeProfileBlock(profilePath) };
+	}
+
+	const profilePath =
+		platform === "win32"
+			? path.join(homeDir, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1")
+			: path.join(homeDir, ".config", "powershell", "Microsoft.PowerShell_profile.ps1");
+	return { shell, completionPath, removed, profilePath, profileUpdated: removeProfileBlock(profilePath) };
+}
+
+/** Reverse of {@link installCompletion} across every supported shell. */
+export function uninstallCompletion(
+	options: { homeDir?: string; platform?: NodeJS.Platform } = {},
+): CompletionUninstallResult[] {
+	const homeDir = options.homeDir ?? os.homedir();
+	const platform = options.platform ?? process.platform;
+	return (["bash", "zsh", "fish", "powershell"] as const).map((shell) =>
+		uninstallShellCompletion(shell, homeDir, platform),
+	);
+}

package/src/core.ts

@@ -1063,6 +1063,17 @@ export function installSkills(): InstallSkillsReport {
 			destDir: path.join(homeDir, ".cursor", "skills", "agent-memory"),
 			homeMarker: path.join(homeDir, ".cursor"),
 		},
+		{
+			label: "Qoder skill",
+			srcDir: path.join(skillsDir, "qoder"),
+			destDir: path.join(homeDir, ".qoder", "skills", "agent-memory"),
+			homeMarker: path.join(homeDir, ".qoder"),
+			detectFiles: [
+				path.join(homeDir, ".qoder", "settings.json"),
+				path.join(homeDir, ".qoder", "settings.local.json"),
+			],
+			detectCommand: "qoder",
+		},
 		{
 			label: "Agent CLI skill",
 			srcDir: path.join(skillsDir, "agent"),