@agentprojectcontext/apx 1.31.0 → 1.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentprojectcontext/apx",
-  "version": "1.31.0",
+  "version": "1.31.1",
   "description": "APX — unified CLI + daemon for the Agent Project Context (APC) standard.",
   "publishConfig": {
     "access": "public"

package/skills/apx-agency-agents/SKILL.md

@@ -59,7 +59,7 @@ apx agent vault list --all
 # Create a new template (writes ~/.apx/agents/<slug>.md)
 apx agent vault add reviewer \
   --role "Code reviewer" \
-  --model claude-haiku-4-5 \
+  --model ollama:llama3.2:3b \
   --language es \
   --skills code-review,git \
   --description "Reviews PRs and pushes back on hand-wavy diffs."

package/skills/apx-agent/SKILL.md

@@ -5,7 +5,7 @@ description: How to create, configure, and use project agents in APX. Load when
 
 # apx-agent
 
-A project agent is a named persona inside an APC project. Canonical definition: `.apc/agents/<slug>.md` (flat file). `AGENTS.md` is auto-regenerated for discovery. Per-agent runtime data: `.apc/agents/<slug>/memory.md` (and optional `sessions/` only when using external runtimes that write APC session stubs — APX-native sessions live under `~/.apx/projects/<id>/`).
+A project agent is a named persona inside an APC project. Canonical definition: `.apc/agents/<slug>.md` (flat file). `AGENTS.md` is auto-regenerated for discovery. Per-agent runtime data (memory, conversations, sessions) lives under `~/.apx/projects/<apx_id>/agents/<slug>/` and is never committed. APX still reads legacy `.apc/agents/<slug>/memory.md` as a migration fallback only.
 
 ## Concrete CLI calls
 
@@ -13,10 +13,10 @@ A project agent is a named persona inside an APC project. Canonical definition:
 # List agents in a project
 apx agent list --project iacrmar
 
-# Create a new agent (writes .apc/agents/<slug>.md + regenerates AGENTS.md)
+# Create a new agent (writes .apc/agents/<slug>.md, creates runtime dir, regenerates AGENTS.md)
 apx agent add reviewer \
   --role "Code reviewer" \
-  --model claude-haiku-4-5 \
+  --model ollama:llama3.2:3b \
   --language es \
   --description "Reviews PRs and pushes back on hand-wavy diffs." \
   --tools read,write,run \
@@ -45,7 +45,7 @@ apx memory <slug> --project iacrmar --replace < file.md       # full replace fro
 2. Description (from AGENTS.md).
 3. Role + Language fields.
 4. Invocation context: `engine | telegram | routine | runtime` — the channel calling the agent.
-5. Memory: `.apc/agents/<slug>/memory.md` if it exists.
+5. Memory: `~/.apx/projects/<apx_id>/agents/<slug>/memory.md` if it exists, with legacy `.apc/agents/<slug>/memory.md` as a migration fallback.
 6. Skills declared in the agent's `Skills:` field, each loaded from `.apc/skills/<slug>.md` or the bundled set.
 7. The `apx` meta-skill (so the agent knows how to operate APX).
 8. ACTION_DISCIPLINE_RULES (fixed footer — anti-ghost, anti-disclaimer, action-first).
@@ -54,13 +54,13 @@ That's the prompt the engine sees on every `apx exec <agent>` or `apx chat <agen
 
 ## Models per agent
 
-Each agent can set `Model:` in its `AGENT.md` to override the global super-agent model. Useful when a particular agent should use a cheaper / smaller / specialized model.
+Each agent can set `Model:` in its `AGENT.md` to override the global super-agent model. Leave it empty when the agent should follow the project/global default.
 
 ```markdown
 # .apc/agents/reviewer.md
 ---
 Role: Code reviewer
-Model: claude-haiku-4-5      ← this agent always uses Haiku, independent of super_agent.model
+Model: ollama:llama3.2:3b    ← this agent uses this model, independent of super_agent.model
 Language: es
 ---
 ```

package/skills/apx-project/SKILL.md

@@ -57,7 +57,6 @@ The CLI calls `resolveProjectId()` which does fuzzy id-or-name-or-path matching.
 └── .apc/
     ├── project.json                            ← { apxId, name, ... }
     ├── agents/<slug>.md
-    ├── agents/<slug>/memory.md
     ├── skills/<slug>.md or <slug>/SKILL.md
     ├── mcps.json                               ← shared MCPs (committed)
     ├── commands/                               ← custom slash-commands
@@ -65,7 +64,7 @@ The CLI calls `resolveProjectId()` which does fuzzy id-or-name-or-path matching.
 
 ~/.apx/projects/<apxId>/                        ← runtime state (never committed)
 ├── messages/YYYY-MM-DD.jsonl
-├── agents/<slug>/{sessions/, conversations/}
+├── agents/<slug>/{memory.md, sessions/, conversations/}
 ├── routines.json
 ├── tasks/YYYY-MM.jsonl
 ├── artifacts/

package/src/core/agent/self-memory.js

@@ -2,7 +2,7 @@
 //
 // This is distinct from:
 //   - identity.json   → who Roby is (name, personality, owner)
-//   - project agents' .apc/agents/<slug>/memory.md → per-agent, per-project
+//   - project agents' ~/.apx/projects/<apx_id>/agents/<slug>/memory.md → per-agent, per-project
 //   - sessions        → raw transcripts of past work (search_sessions)
 //
 // It is a single free-form markdown file at ~/.apx/memory.md that Roby keeps

package/src/core/agent-memory.js

@@ -0,0 +1,64 @@
+import fs from "node:fs";
+import path from "node:path";
+import { projectStorageRoot } from "./config.js";
+import { getOrCreateApxId } from "./scaffold.js";
+
+const EMPTY_MEMORY = (slug) =>
+  `# Memory — ${slug}\n\n` +
+  `## Identity\n- \n\n` +
+  `## Long-term facts\n- \n\n` +
+  `## Recent context\n- \n`;
+
+export function agentRuntimeDir(projectOrRoot, slug) {
+  const storagePath =
+    typeof projectOrRoot === "object" && projectOrRoot?.storagePath
+      ? projectOrRoot.storagePath
+      : null;
+  const root =
+    typeof projectOrRoot === "string"
+      ? projectOrRoot
+      : projectOrRoot?.path;
+  const base = storagePath || projectStorageRoot(getOrCreateApxId(root));
+  return path.join(base, "agents", slug);
+}
+
+export function agentMemoryPath(projectOrRoot, slug) {
+  return path.join(agentRuntimeDir(projectOrRoot, slug), "memory.md");
+}
+
+export function legacyAgentMemoryPath(projectRoot, slug) {
+  return path.join(projectRoot, ".apc", "agents", slug, "memory.md");
+}
+
+export function ensureAgentRuntimeDir(projectOrRoot, slug, { createMemory = false } = {}) {
+  const dir = agentRuntimeDir(projectOrRoot, slug);
+  fs.mkdirSync(dir, { recursive: true });
+  if (createMemory) {
+    const memory = path.join(dir, "memory.md");
+    if (!fs.existsSync(memory)) fs.writeFileSync(memory, EMPTY_MEMORY(slug));
+  }
+  return dir;
+}
+
+export function readAgentMemory(projectOrRoot, slug) {
+  const primary = agentMemoryPath(projectOrRoot, slug);
+  if (fs.existsSync(primary)) return fs.readFileSync(primary, "utf8");
+
+  const root =
+    typeof projectOrRoot === "string"
+      ? projectOrRoot
+      : projectOrRoot?.path;
+  if (root) {
+    const legacy = legacyAgentMemoryPath(root, slug);
+    if (fs.existsSync(legacy)) return fs.readFileSync(legacy, "utf8");
+  }
+
+  return "";
+}
+
+export function writeAgentMemory(projectOrRoot, slug, body) {
+  ensureAgentRuntimeDir(projectOrRoot, slug);
+  const memory = agentMemoryPath(projectOrRoot, slug);
+  fs.writeFileSync(memory, body);
+  return memory;
+}

package/src/core/agent-system.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { readAgentMemory } from "./agent-memory.js";
 
 // ---------------------------------------------------------------------------
 // Anti-ghost-response rules injected into every agent system prompt.
@@ -62,8 +63,8 @@ export function buildAgentSystem(project, agent, {
 
   parts.push(buildInvocationContext({ invocation, runtime, channel, caller, routine }));
 
-  const memPath = path.join(project.path, ".apc", "agents", agent.slug, "memory.md");
-  if (fs.existsSync(memPath)) parts.push("## Memory\n" + fs.readFileSync(memPath, "utf8"));
+  const memory = readAgentMemory(project, agent.slug);
+  if (memory) parts.push("## Memory\n" + memory);
 
   const apxSkill = path.join(project.path, ".apc", "skills", "apx.md");
   if (fs.existsSync(apxSkill)) parts.push("## APX\n" + fs.readFileSync(apxSkill, "utf8"));

package/src/core/scaffold.js

@@ -325,24 +325,60 @@ const AGENTS_MD_TEMPLATE = `# AGENTS.md
 <!-- Hard constraints: what agents must always / never do here. -->
 `;
 
-const APC_GITIGNORE = `# APC runtime data — never in the repository
-# Chat conversations and runtime sessions belong in ~/.apx/projects/<id>/
-agents/*/sessions/
-agents/*/conversations/
+const APC_GITIGNORE = `# APC repository-safe context only.
+# Runtime state belongs in ~/.apx/projects/<id>/, not in .apc/.
+
+# Legacy per-agent runtime dirs (agent definitions are flat: agents/<slug>.md)
+agents/*/
+
+# Runtime sessions / conversations / messages
 sessions/
 conversations/
 messages/
 chats/
+threads/
+transcripts/
+runs/
+
+# Runtime memory, indexes, databases, and caches
+memory.local.md
+auto-memory.md
 cache/
 tmp/
 private/
 secrets/
+*.db
+*.db-*
+*.sqlite
+*.sqlite3
+project.db
+memory.db
+memory-index.jsonl
+memory-cursor.json
+
+# Local config and secrets
+.env
 *.local.json
 *.secret.json
 *.env
 *.env.*
-project.db
+*.key
+*.pem
+*.p12
+*.crt
+credentials.json
+service-account*.json
+token*.json
+mcps.local.json
+config.local.json
+
+# Scratch planning state
+plans/scratch/
+plans/*.local.md
+
+# Migration marker and OS noise
 migrate.md
+.DS_Store
 `;
 
 function nowIso() {
@@ -448,19 +484,8 @@ export function initApf(directory, { name } = {}) {
 }
 
 export function ensureAgentDir(root, slug) {
-  const dir = path.join(root, ".apc", "agents", slug);
-  fs.mkdirSync(dir, { recursive: true });
-  const memory = path.join(dir, "memory.md");
-  if (!fs.existsSync(memory)) {
-    fs.writeFileSync(
-      memory,
-      `# Memory — ${slug}\n\n` +
-        `## Identity\n- \n\n` +
-        `## Long-term facts\n- \n\n` +
-        `## Recent context\n- \n`
-    );
-  }
-  return dir;
+  fs.mkdirSync(path.join(root, ".apc", "agents"), { recursive: true });
+  return path.join(root, ".apc", "agents");
 }
 
 // Write .apc/agents/<slug>.md — the canonical agent definition file.

package/src/core/tools/registry.js

@@ -619,6 +619,8 @@ function makeInlineHandlers({ projects, registries }) {
     memory_list: async (body) => {
       const { default: fs } = await import("node:fs");
       const { default: path } = await import("node:path");
+      const { readAgents } = await import("../parser.js");
+      const { agentMemoryPath } = await import("../agent-memory.js");
       // Find the project
       const all = projects.list();
       let p = null;
@@ -629,15 +631,13 @@ function makeInlineHandlers({ projects, registries }) {
       }
       if (!p) p = projects.get(all.filter((x) => x.id !== 0)[0]?.id) || projects.get(0);
       if (!p) throw new Error("no project registered");
-      const agentsDir = path.join(p.path, ".apc", "agents");
-      if (!fs.existsSync(agentsDir)) return { agents_with_memory: [] };
-      const result = fs.readdirSync(agentsDir).filter((slug) => {
-        return fs.existsSync(path.join(agentsDir, slug, "memory.md"));
-      }).map((slug) => {
-        const memPath = path.join(agentsDir, slug, "memory.md");
+      const result = readAgents(p.path).map((agent) => {
+        const slug = agent.slug;
+        const memPath = agentMemoryPath(p, slug);
+        if (!fs.existsSync(memPath)) return null;
         const stat = fs.statSync(memPath);
         return { agent: slug, path: memPath, size: stat.size, mtime: stat.mtime };
-      });
+      }).filter(Boolean);
       return { project: p.path, agents_with_memory: result };
     },
   };

package/src/host/daemon/api/agents.js

@@ -14,6 +14,13 @@ import {
   restoreVaultAgent,
   ensureAgentDir,
 } from "../../../core/scaffold.js";
+import {
+  ensureAgentRuntimeDir,
+  readAgentMemory,
+  writeAgentMemory,
+  agentMemoryPath,
+  legacyAgentMemoryPath,
+} from "../../../core/agent-memory.js";
 import { agentToResponse } from "./shared.js";
 
 // Lowercase the patch keys we accept on the vault and turn skills/tools into
@@ -114,6 +121,7 @@ export function register(app, { projects, project }) {
     try {
       writeAgentFile(p.path, slug, vault.fields || {}, vault.body || "");
       ensureAgentDir(p.path, slug);
+      ensureAgentRuntimeDir(p, slug);
       projects.rebuild(p.id);
       res.status(201).json(agentToResponse(readAgents(p.path).find((a) => a.slug === slug)));
     } catch (e) {
@@ -133,10 +141,7 @@ export function register(app, { projects, project }) {
     const agents = readAgents(p.path);
     const a = agents.find((x) => x.slug === req.params.slug);
     if (!a) return res.status(404).json({ error: "agent not found" });
-    const memPath = path.join(p.path, ".apc", "agents", a.slug, "memory.md");
-    const memory = fs.existsSync(memPath)
-      ? fs.readFileSync(memPath, "utf8")
-      : "";
+    const memory = readAgentMemory(p, a.slug);
     res.json({ ...agentToResponse(a), memory, system: a.body || "" });
   });
 
@@ -163,6 +168,7 @@ export function register(app, { projects, project }) {
         Parent: parent || null,
       });
       ensureAgentDir(p.path, slug);
+      ensureAgentRuntimeDir(p, slug);
       projects.rebuild(p.id);
       const created = readAgents(p.path).find((a) => a.slug === slug);
       res.status(201).json(agentToResponse(created));
@@ -203,6 +209,7 @@ export function register(app, { projects, project }) {
     try {
       writeAgentFile(p.path, slug, fields, body);
       ensureAgentDir(p.path, slug);
+      ensureAgentRuntimeDir(p, slug);
       projects.rebuild(p.id);
       const updated = readAgents(p.path).find((a) => a.slug === slug);
       res.json(agentToResponse(updated));
@@ -211,18 +218,20 @@ export function register(app, { projects, project }) {
     }
   });
 
-  // Delete an agent: removes .apc/agents/<slug>.md and its data dir.
+  // Delete an agent: removes .apc/agents/<slug>.md and runtime data dir.
   app.delete("/projects/:pid/agents/:slug", (req, res) => {
     const p = project(req, res);
     if (!p) return;
     const slug = req.params.slug;
     const file = path.join(p.path, ".apc", "agents", `${slug}.md`);
-    const dir = path.join(p.path, ".apc", "agents", slug);
-    if (!fs.existsSync(file) && !fs.existsSync(dir))
+    const runtimeDir = path.dirname(agentMemoryPath(p, slug));
+    const legacyDir = path.dirname(legacyAgentMemoryPath(p.path, slug));
+    if (!fs.existsSync(file) && !fs.existsSync(runtimeDir) && !fs.existsSync(legacyDir))
       return res.status(404).json({ error: "agent not found" });
     try {
       if (fs.existsSync(file)) fs.rmSync(file);
-      if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
+      if (fs.existsSync(runtimeDir)) fs.rmSync(runtimeDir, { recursive: true, force: true });
+      if (fs.existsSync(legacyDir)) fs.rmSync(legacyDir, { recursive: true, force: true });
       projects.rebuild(p.id);
       res.json({ ok: true });
     } catch (e) {
@@ -257,15 +266,7 @@ export function register(app, { projects, project }) {
   app.get("/projects/:pid/agents/:slug/memory", (req, res) => {
     const p = project(req, res);
     if (!p) return;
-    const memPath = path.join(
-      p.path,
-      ".apc",
-      "agents",
-      req.params.slug,
-      "memory.md"
-    );
-    if (!fs.existsSync(memPath)) return res.json({ body: "" });
-    res.json({ body: fs.readFileSync(memPath, "utf8") });
+    res.json({ body: readAgentMemory(p, req.params.slug) });
   });
 
   app.put("/projects/:pid/agents/:slug/memory", (req, res) => {
@@ -274,10 +275,7 @@ export function register(app, { projects, project }) {
     const { body } = req.body || {};
     if (typeof body !== "string")
       return res.status(400).json({ error: "body must be string" });
-    const dir = path.join(p.path, ".apc", "agents", req.params.slug);
-    fs.mkdirSync(path.join(dir, "sessions"), { recursive: true });
-    const memPath = path.join(dir, "memory.md");
-    fs.writeFileSync(memPath, body);
+    writeAgentMemory(p, req.params.slug, body);
     projects.rebuild(p.id);
     res.json({ ok: true, bytes: Buffer.byteLength(body, "utf8") });
   });

package/src/host/daemon/api/sessions-search.js

@@ -31,7 +31,7 @@ export function register(app, { projects, config }) {
     for (const p of targetProjects) {
       if (!p) continue;
 
-      // 1) Session files in the repo (.apc/agents/<slug>/sessions/)
+      // 1) Legacy session files in the repo (.apc/agents/<slug>/sessions/)
       const sessionAgentsDir = path.join(p.path, ".apc", "agents");
       if (fs.existsSync(sessionAgentsDir)) {
         for (const slug of fs.readdirSync(sessionAgentsDir)) {

package/src/host/daemon/api/shared.js

@@ -6,6 +6,8 @@ import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { appendErrorTrace, previewText } from "../../../core/logging.js";
+import { readAgents } from "../../../core/parser.js";
+import { agentMemoryPath } from "../../../core/agent-memory.js";
 
 export const nowIso = () =>
   new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -110,15 +112,10 @@ export function makeTopProjectResolver(projects) {
 }
 
 // Pick the memory.md to use when /memory is called without an agent ref.
-// Prefer the first .apc/agents/<slug>/memory.md; else .apc/memory.md.
+// Prefer the first agent's runtime-local memory; else project-level .apc/memory.md.
 export function resolveMemoryPath(p) {
-  const agentsDir = path.join(p.path, ".apc", "agents");
-  if (fs.existsSync(agentsDir)) {
-    const slugs = fs.readdirSync(agentsDir).filter((s) =>
-      fs.statSync(path.join(agentsDir, s)).isDirectory()
-    );
-    if (slugs.length) return path.join(agentsDir, slugs[0], "memory.md");
-  }
+  const firstAgent = readAgents(p.path)[0];
+  if (firstAgent) return agentMemoryPath(p, firstAgent.slug);
   return path.join(p.path, ".apc", "memory.md");
 }
 

package/src/host/daemon/super-agent-tools/tools/import-agent.js

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { readVaultAgents, VAULT_DIR } from "../../../../core/parser.js";
 import { addImportedAgent, ensureAgentDir } from "../../../../core/scaffold.js";
+import { ensureAgentRuntimeDir } from "../../../../core/agent-memory.js";
 import { confirmedProperty, projectMeta, resolveProject } from "../helpers.js";
 
 export default {
@@ -35,6 +36,7 @@ export default {
     const p = resolveProject(projects, project || "default");
     addImportedAgent(p.path, slug);
     ensureAgentDir(p.path, slug);
+    ensureAgentRuntimeDir(p, slug);
     projects.rebuild(p.id);
 
     return {

package/src/host/daemon/super-agent-tools/tools/read-agent-memory.js

@@ -1,6 +1,6 @@
 import fs from "node:fs";
-import path from "node:path";
 import { resolveProject } from "../helpers.js";
+import { agentMemoryPath, readAgentMemory } from "../../../../core/agent-memory.js";
 
 export default {
   name: "read_agent_memory",
@@ -21,8 +21,9 @@ export default {
   },
   makeHandler: ({ projects }) => ({ project, agent }) => {
     const p = resolveProject(projects, project);
-    const file = path.join(p.path, ".apc", "agents", agent, "memory.md");
-    if (!fs.existsSync(file)) return { error: `no memory.md for agent ${agent}` };
-    return { body: fs.readFileSync(file, "utf8") };
+    const file = agentMemoryPath(p, agent);
+    const body = readAgentMemory(p, agent);
+    if (!body && !fs.existsSync(file)) return { error: `no memory.md for agent ${agent}` };
+    return { body, path: file };
   },
 };

package/src/interfaces/cli/commands/agent.js

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { findApfRoot, readAgents, readVaultAgents, readVaultAgent, VAULT_DIR, SLUG_RE } from "../../../core/parser.js";
 import { writeAgentFile, writeVaultAgentFile, removeVaultAgent, restoreVaultAgent, addImportedAgent, ensureAgentDir } from "../../../core/scaffold.js";
+import { ensureAgentRuntimeDir, agentMemoryPath } from "../../../core/agent-memory.js";
 import { http } from "../http.js";
 
 // ── ANSI ──────────────────────────────────────────────────────────────────────
@@ -49,6 +50,7 @@ export async function cmdAgentAdd(args) {
 
   writeAgentFile(root, slug, fields);
   ensureAgentDir(root, slug);
+  ensureAgentRuntimeDir(root, slug);
   await nudgeDaemon(root);
 
   console.log(`Added agent ${slug}`);
@@ -207,10 +209,11 @@ export async function cmdAgentImport(args) {
     addImportedAgent(root, slug);
     console.log(`\n  ${bold(slug)} imported from vault ${tag("↑ vault")}\n`);
     console.log(gray(`  definition: ${vaultPath}`));
-    console.log(gray(`  memory:     ${path.join(root, ".apc", "agents", slug, "memory.md")} (project-local)`));
+    console.log(gray(`  memory:     ${agentMemoryPath(root, slug)} (runtime-local)`));
     console.log();
   }
 
   ensureAgentDir(root, slug);
+  ensureAgentRuntimeDir(root, slug);
   await nudgeDaemon(root);
 }

package/src/interfaces/cli/commands/memory.js

@@ -1,7 +1,6 @@
 import fs from "node:fs";
-import path from "node:path";
 import { findApfRoot } from "../../../core/parser.js";
-import { ensureAgentDir } from "../../../core/scaffold.js";
+import { agentMemoryPath, readAgentMemory, writeAgentMemory, ensureAgentRuntimeDir } from "../../../core/agent-memory.js";
 import { http } from "../http.js";
 
 function requireRoot() {
@@ -23,12 +22,11 @@ export async function cmdMemory(args) {
   const slug = args._[0];
   if (!slug) throw new Error("apx memory: missing <agent-slug>");
   const root = requireRoot();
-  const memPath = path.join(root, ".apc", "agents", slug, "memory.md");
+  const memPath = agentMemoryPath(root, slug);
 
   if (args.flags.replace) {
     const newBody = readStdinSync();
-    ensureAgentDir(root, slug);
-    fs.writeFileSync(memPath, newBody);
+    writeAgentMemory(root, slug, newBody);
     await nudgeDaemon(root);
     console.log(`replaced memory for ${slug} (${Buffer.byteLength(newBody)} bytes)`);
     return;
@@ -36,23 +34,24 @@ export async function cmdMemory(args) {
 
   if (args.flags.append && args.flags.append !== true) {
     const note = String(args.flags.append);
-    ensureAgentDir(root, slug);
-    let body = fs.existsSync(memPath) ? fs.readFileSync(memPath, "utf8") : "";
+    ensureAgentRuntimeDir(root, slug);
+    let body = readAgentMemory(root, slug);
     if (!/##\s+Recent context/i.test(body)) {
       body += body.endsWith("\n") ? "\n## Recent context\n" : "\n\n## Recent context\n";
     }
     const today = new Date().toISOString().slice(0, 10);
     body = body.replace(/(##\s+Recent context\s*\n)/i, `$1- ${today}: ${note}\n`);
-    fs.writeFileSync(memPath, body);
+    writeAgentMemory(root, slug, body);
     await nudgeDaemon(root);
     console.log(`appended to ${slug} memory: ${note}`);
     return;
   }
 
-  if (!fs.existsSync(memPath)) {
+  const body = readAgentMemory(root, slug);
+  if (!body && !fs.existsSync(memPath)) {
     throw new Error(`no memory for "${slug}" — agent dir not yet created`);
   }
-  process.stdout.write(fs.readFileSync(memPath, "utf8"));
+  process.stdout.write(body);
 }
 
 function readStdinSync() {