@technomoron/agent-run 0.99.7 → 0.99.9

package/CHANGES

@@ -4,6 +4,15 @@ CHANGES
 Unreleased (2026-04-24)
 -----------------------
 
+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.
+
 Version 0.99.7 (2026-04-26)
 ---------------------------
 * Add a checked-in basic starter config under `examples/basic-config` that exercises manifests, templates, snippets, skills, overrides, guardrails, checks, and generated runtime paths.

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);
@@ -1459,7 +1459,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 +1482,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 +1498,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 +1520,14 @@ 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 = path.join(configRoot, 'notes', 'memory');
+    return fs.existsSync(memoryDir) ? ['--add-dir', memoryDir] : [];
+}
 function postflightProjectCheck(projectRoot, agentDir, code) {
     const localAiFiles = findLocalAiFiles(projectRoot, agentDir);
     if (localAiFiles.length === 0) {
@@ -1881,11 +1887,32 @@ function findRealBinary(tool) {
             if (resolvedCandidate === currentScript || wrapperCandidates.has(resolvedCandidate)) {
                 continue;
             }
+            if (isAgentRunRedirectShim(candidate)) {
+                verbose(`skip ${tool} redirect shim: ${candidate}`);
+                continue;
+            }
             return candidate;
         }
     }
     fail(`no ${tool} binary found in PATH`);
 }
+function isAgentRunRedirectShim(filePath) {
+    try {
+        const handle = fs.openSync(filePath, 'r');
+        try {
+            const buffer = Buffer.alloc(4096);
+            const bytesRead = fs.readSync(handle, buffer, 0, buffer.length, 0);
+            const content = buffer.subarray(0, bytesRead).toString('utf8');
+            return content.includes('Run agent-run instead');
+        }
+        finally {
+            fs.closeSync(handle);
+        }
+    }
+    catch {
+        return false;
+    }
+}
 function getExecutableExtensions(tool) {
     if (!IS_WINDOWS || path.extname(tool)) {
         return [''];

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/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/package.json

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