myagentmemory 0.5.1 → 0.5.3

package/dist/upgrade.js

@@ -1,12 +1,18 @@
 /**
  * Upgrade orchestration for the `agent-memory` CLI and its official Pro plugin bundle.
  *
- * Two consumers:
+ * Three consumers:
  *   1. `agent-memory upgrade` — explicit user command; checks and (optionally) installs.
- *   2. `agent-memory hook session-start` — passive notice from a 24h-cached record.
+ *   2. `agent-memory upgrade --background` — detached, non-interactive; checks, then
+ *      installs any target whose `readUpgradePolicy()` value is `"auto"` (the default).
+ *      Spawned by `refreshUpgradeCacheBackground()` from `hook session-start`.
+ *   3. `agent-memory hook session-start` — passive notice from a 24h-cached record,
+ *      including the outcome of the last `--background` auto-install attempt.
  *
  * Network calls always have a hard timeout and always fail closed (upgrade is a
- * quality-of-life feature; a flaky registry must never break the CLI).
+ * quality-of-life feature; a flaky registry must never break the CLI). Same fail-closed
+ * contract applies to auto-install: a failed background install is recorded, never
+ * retried before the next cache refresh, and never thrown.
  */
 import { spawn, spawnSync } from "node:child_process";
 import * as fs from "node:fs";
@@ -50,6 +56,15 @@ async function fetchLatestFromNpm(fetchImpl = globalThis.fetch) {
 function upgradeCachePath() {
     return path.join(getMemoryDir(), "state", "upgrade-check.json");
 }
+function isValidAutoOutcome(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.at === "string" &&
+        typeof candidate.ok === "boolean" &&
+        (candidate.version === null || typeof candidate.version === "string") &&
+        (candidate.error === undefined || typeof candidate.error === "string"));
+}
 export function readUpgradeCache() {
     try {
         const raw = fs.readFileSync(upgradeCachePath(), "utf-8");
@@ -69,6 +84,8 @@ export function readUpgradeCache() {
             cliLatest: parsed.cliLatest ?? null,
             pluginCurrent: parsed.pluginCurrent ?? null,
             pluginLatest: parsed.pluginLatest ?? null,
+            cliAuto: isValidAutoOutcome(parsed.cliAuto) ? parsed.cliAuto : undefined,
+            pluginAuto: isValidAutoOutcome(parsed.pluginAuto) ? parsed.pluginAuto : undefined,
         };
     }
     catch {
@@ -93,6 +110,60 @@ export function isCacheFresh(record, now = Date.now()) {
         return false;
     return now - checked < CACHE_TTL_MS;
 }
+const UPGRADE_POLICY_FILENAME = "upgrade-policy.json";
+const UPGRADE_POLICY_DEFAULT = { cli: "auto", plugin: "auto" };
+function upgradePolicyPath() {
+    return path.join(getMemoryDir(), "state", UPGRADE_POLICY_FILENAME);
+}
+function isPolicyValue(value) {
+    return value === "off" || value === "notify" || value === "auto";
+}
+/**
+ * Resolve the persisted auto-upgrade policy.
+ * Precedence per target: `AGENT_MEMORY_AUTO_UPGRADE_{CLI,PLUGIN}` env var →
+ * `<memoryDir>/state/upgrade-policy.json` → default `"auto"`.
+ *
+ * `existed` tells callers whether the policy file was already on disk —
+ * used to fire a one-time "auto-upgrade is on" notice on first read.
+ */
+export function readUpgradePolicy() {
+    let stored = {};
+    let existed = false;
+    try {
+        const raw = fs.readFileSync(upgradePolicyPath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (isPolicyValue(parsed.cli) || isPolicyValue(parsed.plugin)) {
+            stored = parsed;
+            existed = true;
+        }
+    }
+    catch { }
+    const envCli = process.env.AGENT_MEMORY_AUTO_UPGRADE_CLI;
+    const envPlugin = process.env.AGENT_MEMORY_AUTO_UPGRADE_PLUGIN;
+    return {
+        cli: isPolicyValue(envCli) ? envCli : isPolicyValue(stored.cli) ? stored.cli : UPGRADE_POLICY_DEFAULT.cli,
+        plugin: isPolicyValue(envPlugin)
+            ? envPlugin
+            : isPolicyValue(stored.plugin)
+                ? stored.plugin
+                : UPGRADE_POLICY_DEFAULT.plugin,
+        existed,
+    };
+}
+/** Atomically persist the auto-upgrade policy. Merges with whatever is already on disk. */
+export function writeUpgradePolicy(patch) {
+    const current = readUpgradePolicy();
+    const next = {
+        cli: patch.cli ?? current.cli,
+        plugin: patch.plugin ?? current.plugin,
+    };
+    const target = upgradePolicyPath();
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    const temporary = `${target}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+    fs.renameSync(temporary, target);
+    return next;
+}
 // ---------------------------------------------------------------------------
 // Install-method detection
 // ---------------------------------------------------------------------------
@@ -163,8 +234,10 @@ export function runInstaller(method, opts = {}) {
 // ---------------------------------------------------------------------------
 /**
  * Fire-and-forget: spawn a detached child that runs `agent-memory upgrade
- * --check --refresh --quiet` so the next session-start has a fresh cache.
- * Never awaits, never throws.
+ * --background --refresh --quiet` so the next session-start has a fresh
+ * cache. Unlike a plain check, `--background` also installs any target whose
+ * policy is `"auto"` (see `readUpgradePolicy`) — this is the one place
+ * auto-upgrade actually happens. Never awaits, never throws.
  */
 export function refreshUpgradeCacheBackground() {
     try {
@@ -172,7 +245,7 @@ export function refreshUpgradeCacheBackground() {
         const script = process.argv[1];
         if (!binary || !script)
             return;
-        const child = spawn(binary, [script, "upgrade", "--check", "--refresh", "--quiet", "--json"], {
+        const child = spawn(binary, [script, "upgrade", "--background", "--refresh", "--quiet", "--json"], {
             detached: true,
             stdio: "ignore",
             env: { ...process.env, AGENT_MEMORY_UPGRADE_BACKGROUND: "1" },
@@ -231,13 +304,40 @@ export async function checkForUpgrades(opts) {
         fromCache,
     };
 }
-export function formatUpgradeNotice(status) {
+/**
+ * `cache` (when passed) lets this distinguish a plain "notify" signal from the
+ * outcome of the last `--background` auto-install attempt for that target:
+ *   - succeeded, but this process is running older code than what's on disk
+ *     (e.g. a long-running `serve --mcp`) → "auto-upgraded, restart to use it"
+ *   - failed → surface the error and point at the manual command
+ *   - succeeded and already caught up (this process's own version matches) → silent
+ */
+export function formatUpgradeNotice(status, cache) {
     const parts = [];
-    if (status.cli.upgradeAvailable)
+    let needsManualRun = false;
+    if (cache?.cliAuto && !cache.cliAuto.ok) {
+        parts.push(`CLI auto-upgrade failed (${cache.cliAuto.error ?? "unknown error"})`);
+        needsManualRun = true;
+    }
+    else if (cache?.cliAuto?.ok && cache.cliAuto.version && cache.cliAuto.version !== status.cli.current) {
+        parts.push(`CLI auto-upgraded → ${cache.cliAuto.version} (restart any long-running agent-memory process to use it)`);
+    }
+    else if (status.cli.upgradeAvailable) {
         parts.push(`CLI ${status.cli.current} → ${status.cli.latest ?? "new"}`);
-    if (status.plugin.upgradeAvailable)
+        needsManualRun = true;
+    }
+    if (cache?.pluginAuto && !cache.pluginAuto.ok) {
+        parts.push(`Pro auto-upgrade failed (${cache.pluginAuto.error ?? "unknown error"})`);
+        needsManualRun = true;
+    }
+    else if (cache?.pluginAuto?.ok && cache.pluginAuto.version && cache.pluginAuto.version !== status.plugin.current) {
+        parts.push(`Pro auto-upgraded → ${cache.pluginAuto.version}`);
+    }
+    else if (status.plugin.upgradeAvailable) {
         parts.push(`Pro ${status.plugin.current ?? "?"} → ${status.plugin.latest ?? "new"}`);
+        needsManualRun = true;
+    }
     if (!parts.length)
         return null;
-    return `agent-memory: upgrade available (${parts.join(", ")}). Run: agent-memory upgrade`;
+    return `agent-memory: ${parts.join("; ")}${needsManualRun ? ". Run: agent-memory upgrade" : ""}`;
 }

package/docs/official-plugin-bootstrap.md

@@ -267,7 +267,7 @@ An install or upgrade must:
 
 Failure before activation leaves the previous version active. Failure immediately after activation restores the previous receipt. Concurrent installers do not interleave. The core never invokes package-manager lifecycle scripts or elevates privileges.
 
-Uninstall removes executable versions, the active receipt, contributed skills, and managed hooks. It does not remove `MEMORY.md`, daily logs, topics, scratchpad items, source session logs, plugin-created review data, or billing state. A separate future purge command would require explicit scope and confirmation.
+Uninstall removes executable versions, the active receipt, contributed skills, and managed hooks. It does not remove `MEMORY.md`, daily logs, topics, scratchpad items, source session logs, plugin-created review data, or billing state. The top-level `agent-memory uninstall` command composes this with hook/skill/MCP/completion removal in one step; its explicit `--data` flag additionally deletes the memory directory and the entire plugin install root (bundles, receipts, and the activation credential) once the user opts in and confirms.
 
 ## Plugin host API v1
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "myagentmemory",
-	"version": "0.5.1",
+	"version": "0.5.3",
 	"description": "agentmemory (agent-memory) is persistent memory for coding agents (Claude Code, OpenAI 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/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"),