@technomoron/agent-run 0.99.8 → 0.99.10

package/CHANGES

@@ -4,6 +4,15 @@ CHANGES
 Unreleased (2026-04-24)
 -----------------------
 
+Version 0.99.10 (2026-04-27)
+----------------------------
+* Add `paths.globalMemoryDir` to render context and expose it from default Codex, Claude, AGENTS, and CLAUDE templates.
+
+Version 0.99.9 (2026-04-26)
+---------------------------
+* Add `{config-root}/notes/memory` as an optional shared memory directory passed with `--add-dir` to Codex and Claude when it exists.
+* Add a starter `skills/personal-memory.md` file to the packaged config skeleton.
+
 Version 0.99.8 (2026-04-26)
 ---------------------------
 * Skip stale `codex` or `claude` PATH redirect shims that print `Run agent-run instead` when locating the real underlying tool binary.

package/README.md

@@ -169,8 +169,9 @@ Per-profile override templates can be placed in:
 
 A complete starter lives in `examples/basic-config`. It includes a minimal
 project, `.agent-run.env`, a config root with global templates and snippets,
-profile-local templates, skill templates, profile skill overrides, tool config
-overrides, guardrails, checks, and generated runtime paths.
+profile-local templates, skill templates, a personal memory skill, profile
+skill overrides, tool config overrides, guardrails, checks, and generated
+runtime paths.
 
 To copy the packaged starter config root into your default config location:
 

package/dist/agent-run.js

@@ -482,10 +482,10 @@ function runTool(parsed) {
     ensureRunnableProfile(configRoot, agentDir, profile);
     syncAgentProfile(projectRoot, agentDir);
     if (command === 'codex') {
-        runCodex(realBinary, permissionArgs, agentDir, args, projectRoot, wrapperArgs);
+        runCodex(realBinary, permissionArgs, agentDir, configRoot, args, projectRoot, wrapperArgs);
         return;
     }
-    runClaude(realBinary, permissionArgs, agentDir, args, projectRoot);
+    runClaude(realBinary, permissionArgs, agentDir, configRoot, args, projectRoot);
 }
 function runInit(parsed) {
     const projectRoot = findProjectRoot(parsed.targetPath);
@@ -972,6 +972,7 @@ function buildRenderContext(projectRoot, agentDir, configRoot, manifest, env) {
         reviewDir: resolveRuntimePath(configRoot, manifest.paths.reviewDir, env, baseContext),
         reviewFile: resolveRuntimePath(configRoot, manifest.paths.reviewFile, env, baseContext),
         memoriesDir: resolveRuntimePath(configRoot, manifest.paths.memoriesDir, env, baseContext),
+        globalMemoryDir: globalMemoryDir(configRoot),
         codexHomeDir: path.join(resolveRuntimePath(configRoot, manifest.paths.memoriesDir, env, baseContext), 'codex-home'),
         overridesDir: path.join(agentDir, 'overrides'),
         codexSkillsDir: path.join(agentDir, '.agents', 'skills'),
@@ -1459,7 +1460,7 @@ function countWarnings(findings) {
 function formatError(error) {
     return error instanceof Error ? error.message : String(error);
 }
-function runCodex(realBinary, permissionArgs, agentDir, args, projectRoot, wrapperArgs) {
+function runCodex(realBinary, permissionArgs, agentDir, configRoot, args, projectRoot, wrapperArgs) {
     const agentsPath = path.join(agentDir, 'AGENTS.md');
     if (!fs.existsSync(agentsPath)) {
         failMissingConfig('codex', agentDir);
@@ -1482,6 +1483,7 @@ function runCodex(realBinary, permissionArgs, agentDir, args, projectRoot, wrapp
         `system_prompt_file=${agentsPath}`,
         '--config',
         'project_doc_max_bytes=65536',
+        ...globalMemoryArgs(configRoot),
         '-C',
         projectRoot,
         ...(wrapperArgs.codexSandboxMode === 'sandboxed' && wrapperArgs.codexNetwork
@@ -1497,7 +1499,7 @@ function buildCodexRuntimeArgs(wrapperArgs) {
     }
     return ['-a', 'never', '-s', 'danger-full-access'];
 }
-function runClaude(realBinary, permissionArgs, agentDir, args, projectRoot) {
+function runClaude(realBinary, permissionArgs, agentDir, configRoot, args, projectRoot) {
     const claudePath = path.join(agentDir, 'CLAUDE.md');
     if (!fs.existsSync(claudePath)) {
         failMissingConfig('claude', agentDir);
@@ -1519,9 +1521,17 @@ function runClaude(realBinary, permissionArgs, agentDir, args, projectRoot) {
         projectRoot,
         '--add-dir',
         agentDir,
+        ...globalMemoryArgs(configRoot),
         ...args
     ], shouldUseShell(realBinary), env, projectRoot, (code) => postflightProjectCheck(projectRoot, agentDir, code));
 }
+function globalMemoryArgs(configRoot) {
+    const memoryDir = globalMemoryDir(configRoot);
+    return fs.existsSync(memoryDir) ? ['--add-dir', memoryDir] : [];
+}
+function globalMemoryDir(configRoot) {
+    return path.join(configRoot, 'notes', 'memory');
+}
 function postflightProjectCheck(projectRoot, agentDir, code) {
     const localAiFiles = findLocalAiFiles(projectRoot, agentDir);
     if (localAiFiles.length === 0) {
@@ -2210,6 +2220,12 @@ function defaultToolInstructionsTemplate(isClaude) {
         '{{ paths.memoriesDir }}',
         '```',
         '',
+        'Global memory directory:',
+        '',
+        '```text',
+        '{{ paths.globalMemoryDir }}',
+        '```',
+        '',
         'Changes file:',
         '',
         '```text',
@@ -2245,7 +2261,8 @@ function defaultCodexConfigTemplate() {
         '[sandbox_workspace_write]',
         'writable_roots = [',
         '  "{{ projectRoot }}",',
-        '  "{{ agentDir }}"',
+        '  "{{ agentDir }}",',
+        '  "{{ paths.globalMemoryDir }}"',
         ']',
         'network_access = false',
         ''
@@ -2256,7 +2273,8 @@ function defaultClaudeSettingsTemplate() {
         '{',
         '  "env": {',
         '    "AGENT_DIR": "{{ agentDir }}",',
-        '    "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}"',
+        '    "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}",',
+        '    "AGENT_GLOBAL_MEMORY_DIR": "{{ paths.globalMemoryDir }}"',
         '  }',
         '}',
         ''
@@ -2272,7 +2290,8 @@ function defaultCodexConfigContent(context) {
         '[sandbox_workspace_write]',
         'writable_roots = [',
         `  ${jsonString(context.projectRoot)},`,
-        `  ${jsonString(context.agentDir)}`,
+        `  ${jsonString(context.agentDir)},`,
+        `  ${jsonString(context.paths.globalMemoryDir)}`,
         ']',
         'network_access = false',
         ''
@@ -2282,7 +2301,8 @@ function defaultClaudeSettingsContent(context) {
     return `${JSON.stringify({
         env: {
             AGENT_DIR: context.agentDir,
-            AGENT_RUN_PROJECT_ROOT: context.projectRoot
+            AGENT_RUN_PROJECT_ROOT: context.projectRoot,
+            AGENT_GLOBAL_MEMORY_DIR: context.paths.globalMemoryDir
         }
     }, null, 2)}\n`;
 }

package/examples/basic-config/README.md

@@ -8,8 +8,8 @@ It contains two pieces:
 - `project/`: a minimal project with `.agent-run.env` pointing at the bundled
   config root.
 - `agent-config/`: a complete config root with global templates, snippets,
-  skill templates, a profile manifest, profile-local instructions, and profile
-  overrides.
+  skill templates, a personal memory skill, a profile manifest, profile-local
+  instructions, and profile overrides.
 
 Try it from this repository after building:
 

package/examples/basic-config/agent-config/global/tool-templates/AGENTS.md.njk

@@ -12,6 +12,7 @@ Do not edit this generated file. Edit `agent-run.jsonc` and `local.md.njk`.
 - agentDir: `{{ agentDir }}`
 - reviewFile: `{{ paths.reviewFile }}`
 - memoriesDir: `{{ paths.memoriesDir }}`
+- globalMemoryDir: `{{ paths.globalMemoryDir }}`
 
 ## Skills
 

package/examples/basic-config/agent-config/global/tool-templates/CLAUDE.md.njk

@@ -5,3 +5,5 @@
 
 {% endfor %}
 Claude reads this file from the private agent directory.
+
+globalMemoryDir: `{{ paths.globalMemoryDir }}`

package/examples/basic-config/agent-config/global/tool-templates/claude-settings.json.njk

@@ -2,6 +2,7 @@
   "env": {
     "AGENT_DIR": "{{ agentDir }}",
     "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}",
+    "AGENT_GLOBAL_MEMORY_DIR": "{{ paths.globalMemoryDir }}",
     "STARTER_PROFILE": "{{ profile }}"
   }
 }

package/examples/basic-config/agent-config/global/tool-templates/codex-config.toml.njk

@@ -6,6 +6,7 @@ sandbox_mode = "workspace-write"
 writable_roots = [
   "{{ projectRoot }}",
   "{{ agentDir }}",
-  "{{ paths.memoriesDir }}"
+  "{{ paths.memoriesDir }}",
+  "{{ paths.globalMemoryDir }}"
 ]
 network_access = false

package/examples/basic-config/agent-config/skills/personal-memory.md

@@ -0,0 +1 @@
+Read `./notes/memory/README.md` first. Follow its file index and read only the files relevant to the current task. Do not edit memory files unless the user explicitly asks.

package/examples/basic-config/agent-config/starter/basic-project/overrides/claude-settings.json.njk

@@ -2,6 +2,7 @@
   "env": {
     "AGENT_DIR": "{{ agentDir }}",
     "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}",
+    "AGENT_GLOBAL_MEMORY_DIR": "{{ paths.globalMemoryDir }}",
     "STARTER_PROFILE": "{{ profile }}",
     "STARTER_OVERRIDE": "true"
   }

package/examples/basic-config/agent-config/starter/basic-project/overrides/codex-config.toml.njk

@@ -6,6 +6,7 @@ sandbox_mode = "workspace-write"
 writable_roots = [
   "{{ projectRoot }}",
   "{{ agentDir }}",
-  "{{ paths.memoriesDir }}"
+  "{{ paths.memoriesDir }}",
+  "{{ paths.globalMemoryDir }}"
 ]
 network_access = false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@technomoron/agent-run",
-  "version": "0.99.8",
+  "version": "0.99.10",
   "packageManager": "pnpm@10.28.1",
   "bin": {
     "agent-run": "dist/agent-run.js"