@technomoron/agent-run 0.99.9 → 0.99.11

package/CHANGES

@@ -4,6 +4,14 @@ CHANGES
 Unreleased (2026-04-24)
 -----------------------
 
+Version 0.99.11 (2026-04-27)
+----------------------------
+* Show the package version in `agent-run --help` and add `agent-run --version`.
+
+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.

package/dist/agent-run.js

@@ -22,6 +22,7 @@ const CONFIG_DIR_ENV = 'AGENT_CONFIG_DIR';
 const VERBOSE_ENV = 'AGENT_RUN_VERBOSE';
 const MANIFEST_FILE_NAME = 'agent-run.jsonc';
 const LOCAL_TEMPLATE_FILE_NAME = 'local.md.njk';
+const PACKAGE_VERSION = '0.99.10';
 const UNEXPANDED_TEMPLATE_RE = /\{\{[^}]+\}\}|\{%[^%]+%\}/;
 const agentRunEnvCache = new Map();
 const GENERATED_GITIGNORE_ENTRIES = [
@@ -114,6 +115,9 @@ function parseInvocation(invokedTool, argv) {
         if (isHelpFlag(firstArg)) {
             printHelp('general');
         }
+        if (isVersionFlag(firstArg)) {
+            printVersion();
+        }
         const commandIndex = findCommandArgIndex(inputArgs);
         if (commandIndex === -1) {
             fail(`unknown command: ${firstArg ?? ''} (run with --help for usage)`);
@@ -341,6 +345,13 @@ function parseMigrateConfigCommand(inputArgs) {
 function isHelpFlag(value) {
     return value === '-h' || value === '--help';
 }
+function isVersionFlag(value) {
+    return value === '-V' || value === '--version';
+}
+function printVersion() {
+    process.stdout.write(`agent-run ${agentRunVersion()}\n`);
+    process.exit(0);
+}
 function printHelp(topic) {
     process.stdout.write(renderHelp(topic));
     process.exit(0);
@@ -394,6 +405,8 @@ function renderHelp(topic) {
         case 'general':
         default:
             return [
+                `agent-run ${agentRunVersion()}`,
+                '',
                 'Usage:',
                 '  agent-run <codex|claude|check|init|edit|update> [options]',
                 '  agent-run --init [config-root]',
@@ -410,6 +423,7 @@ function renderHelp(topic) {
                 '',
                 'Global options:',
                 '  -h, --help         Show this help text',
+                '  -V, --version      Show the agent-run version',
                 '  -v, --verbose      Print path resolution and wrapper actions',
                 '  --config-root DIR  Override the agent-config root',
                 '  --init [DIR]       Copy the packaged starter config root to DIR (default ~/.agent-config)',
@@ -422,6 +436,19 @@ function renderHelp(topic) {
             ].join('\n');
     }
 }
+function agentRunVersion() {
+    const packagePath = path.resolve(__dirname, '..', 'package.json');
+    try {
+        const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+        if (typeof pkg.version === 'string' && pkg.version.length > 0) {
+            return pkg.version;
+        }
+    }
+    catch {
+        return PACKAGE_VERSION;
+    }
+    return PACKAGE_VERSION;
+}
 function normalizeCommandName(value) {
     if (!value) {
         return null;
@@ -972,6 +999,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'),
@@ -1525,9 +1553,12 @@ function runClaude(realBinary, permissionArgs, agentDir, configRoot, args, proje
     ], shouldUseShell(realBinary), env, projectRoot, (code) => postflightProjectCheck(projectRoot, agentDir, code));
 }
 function globalMemoryArgs(configRoot) {
-    const memoryDir = path.join(configRoot, 'notes', 'memory');
+    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) {
@@ -2216,6 +2247,12 @@ function defaultToolInstructionsTemplate(isClaude) {
         '{{ paths.memoriesDir }}',
         '```',
         '',
+        'Global memory directory:',
+        '',
+        '```text',
+        '{{ paths.globalMemoryDir }}',
+        '```',
+        '',
         'Changes file:',
         '',
         '```text',
@@ -2251,7 +2288,8 @@ function defaultCodexConfigTemplate() {
         '[sandbox_workspace_write]',
         'writable_roots = [',
         '  "{{ projectRoot }}",',
-        '  "{{ agentDir }}"',
+        '  "{{ agentDir }}",',
+        '  "{{ paths.globalMemoryDir }}"',
         ']',
         'network_access = false',
         ''
@@ -2262,7 +2300,8 @@ function defaultClaudeSettingsTemplate() {
         '{',
         '  "env": {',
         '    "AGENT_DIR": "{{ agentDir }}",',
-        '    "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}"',
+        '    "AGENT_RUN_PROJECT_ROOT": "{{ projectRoot }}",',
+        '    "AGENT_GLOBAL_MEMORY_DIR": "{{ paths.globalMemoryDir }}"',
         '  }',
         '}',
         ''
@@ -2278,7 +2317,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',
         ''
@@ -2288,7 +2328,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/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/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.9",
+  "version": "0.99.11",
   "packageManager": "pnpm@10.28.1",
   "bin": {
     "agent-run": "dist/agent-run.js"