@technomoron/agent-run 0.99.14 → 0.99.15

package/CHANGES

@@ -1,6 +1,10 @@
 CHANGES
 =======
 
+Version 0.99.15 (2026-04-30)
+----------------------------
+* Add `--generate` for Codex and Claude runs to render generated files without launching the underlying tool.
+
 Version 0.99.14 (2026-04-30)
 ----------------------------
 * Add `--show` for Codex and Claude runs to print the tool-specific source templates/includes and generated files without launching the underlying tool.

package/README.md

@@ -110,6 +110,9 @@ Global flag:
 `agent-run codex --help` and `agent-run claude --help` still pass `--help`
 through to the underlying tool.
 
+For `codex` and `claude`, use `--generate` to generate profile files without
+launching the underlying tool.
+
 Codex defaults to `--danger`, which launches Codex with `-a never -s danger-full-access`,
 sets `CODEX_HOME` under the private agent directory, starts the Codex process
 from that private directory, passes the project root with `-C`, and keeps
@@ -155,6 +158,13 @@ Regenerate the generated files for the current repo:
 agent-run update
 ```
 
+You can also generate from a tool command and stop before launch:
+
+```sh
+agent-run codex --generate
+agent-run claude --generate
+```
+
 This reads `agent-run.jsonc` and Nunjucks templates from the mapped profile
 directory and rewrites generated files:
 

package/dist/agent-run.js

@@ -203,6 +203,7 @@ function parseRunCommand(command, inputArgs) {
         create: false,
         local: false,
         show: false,
+        generate: false,
         codexSandboxMode: null,
         codexNetwork: false
     };
@@ -233,6 +234,10 @@ function parseRunCommand(command, inputArgs) {
             wrapperArgs.show = true;
             continue;
         }
+        if (arg === '--generate') {
+            wrapperArgs.generate = true;
+            continue;
+        }
         if (arg === '--danger') {
             if (command !== 'codex') {
                 fail('--danger is only supported for agent-run codex');
@@ -407,9 +412,9 @@ function renderHelp(topic) {
                 '  agent-run --init [config-root]',
                 '',
                 'Commands:',
-                '  codex [--none] [--create] [--local] [--show] [--danger|--sandboxed] [--network] [args...]',
+                '  codex [--none] [--create] [--local] [--show] [--generate] [--danger|--sandboxed] [--network] [args...]',
                 '                                           Run codex with generated private config',
-                '  claude [--none] [--create] [--local] [--show] [args...]',
+                '  claude [--none] [--create] [--local] [--show] [--generate] [args...]',
                 '                                           Run claude with generated private config',
                 '  check [--all] [path]                  Validate generated profile output',
                 '  init [path]                           Create profile source files and render output',
@@ -427,6 +432,7 @@ function renderHelp(topic) {
                 'Run wrapper options:',
                 '  --local            Warn about local AI files instead of failing',
                 '  --show             Show read/include and generated files without running the tool',
+                '  --generate         Generate files without running the tool',
                 '',
                 'Codex wrapper options:',
                 '  --danger           Run Codex with no sandbox: -a never -s danger-full-access (default)',
@@ -487,9 +493,18 @@ function runTool(parsed) {
     if (wrapperArgs.show && wrapperArgs.none) {
         fail('--show cannot be combined with --none');
     }
+    if (wrapperArgs.generate && wrapperArgs.none) {
+        fail('--generate cannot be combined with --none');
+    }
+    if (wrapperArgs.generate && wrapperArgs.show) {
+        fail('--generate cannot be combined with --show');
+    }
     if (wrapperArgs.show && isIgnoredDir(projectRoot)) {
         fail(`cannot show generated ${command} files for ignored project: ${projectRoot}`);
     }
+    if (wrapperArgs.generate && isIgnoredDir(projectRoot)) {
+        fail(`cannot generate ${command} files for ignored project: ${projectRoot}`);
+    }
     if (wrapperArgs.none || isIgnoredDir(projectRoot)) {
         const realBinary = findRealBinary(command);
         const permissionArgs = getPermissionArgs(command);
@@ -508,6 +523,15 @@ function runTool(parsed) {
         showToolProfile(command, projectRoot, agentDir);
         return;
     }
+    if (wrapperArgs.create) {
+        runInit({ command: 'init', targetPath: projectRoot });
+    }
+    ensureRunnableProfile(configRoot, agentDir, profile);
+    if (wrapperArgs.generate) {
+        const rendered = syncAgentProfile(projectRoot, agentDir);
+        printUpdateSummary(rendered);
+        return;
+    }
     const localAiFiles = findLocalAiFiles(projectRoot, agentDir);
     if (localAiFiles.length > 0) {
         if (!wrapperArgs.local) {
@@ -517,10 +541,6 @@ function runTool(parsed) {
     }
     const realBinary = findRealBinary(command);
     const permissionArgs = getPermissionArgs(command);
-    if (wrapperArgs.create) {
-        runInit({ command: 'init', targetPath: projectRoot });
-    }
-    ensureRunnableProfile(configRoot, agentDir, profile);
     syncAgentProfile(projectRoot, agentDir);
     if (command === 'codex') {
         runCodex(realBinary, permissionArgs, agentDir, configRoot, args, projectRoot, wrapperArgs);

package/package.json

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