@meandmyagents/agent-runner 0.1.0 → 0.1.1

package/README.md

@@ -13,6 +13,14 @@ process as `MAA_API_KEY`, so one Mac can run several agent profiles without
 sharing identity. The launched agent uses MCP to start, complete, and drain the
 remaining actionable cards.
 
+On macOS, `--launcher codex` will also look for the bundled Codex app executable
+at `/Applications/Codex.app/Contents/Resources/codex` when `codex` is not on
+`PATH`. If your launcher lives somewhere else, pass it explicitly:
+
+```bash
+meandmyagents-runner watch --key maa_live_YOUR_AGENT_KEY --launcher codex --command /Applications/Codex.app/Contents/Resources/codex
+```
+
 ```bash
 meandmyagents-runner watch --key maa_live_YOUR_AGENT_KEY --launcher claude --once
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meandmyagents/agent-runner",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local visible-session task runner for Me And My Agents.",
   "type": "module",
   "bin": {

package/src/runner.js

@@ -1,15 +1,18 @@
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { delimiter, join } from "node:path";
 
 export const defaultApiUrl = "https://meandmyagents.com/api";
 const supportedLaunchers = new Set(["codex", "claude"]);
 
 export function parseRunnerArgs(argv = process.argv.slice(2)) {
   const options = {
-    command: argv[0] ?? "help",
+    command: argv[0] === "--help" || argv[0] === "-h" ? "help" : argv[0] ?? "help",
     apiUrl: defaultApiUrl,
     intervalSeconds: 10,
     key: "",
     launcher: "codex",
+    launcherCommand: "",
     once: false
   };
 
@@ -34,6 +37,12 @@ export function parseRunnerArgs(argv = process.argv.slice(2)) {
       continue;
     }
 
+    if (arg === "--command" || arg === "-c") {
+      options.launcherCommand = argv[index + 1] ?? "";
+      index += 1;
+      continue;
+    }
+
     if (arg === "--interval") {
       options.intervalSeconds = Number(argv[index + 1] ?? "10");
       index += 1;
@@ -84,13 +93,20 @@ export function buildAgentPrompt({
   ].join("\n");
 }
 
-export function buildLaunchCommand({ launcher, prompt, cwd, apiKey, apiUrl }) {
+export function buildLaunchCommand({
+  launcher,
+  launcherCommand,
+  prompt,
+  cwd,
+  apiKey,
+  apiUrl
+}) {
   if (!supportedLaunchers.has(launcher)) {
     throw new Error(`Unsupported launcher: ${launcher}`);
   }
 
   return {
-    command: launcher,
+    command: launcherCommand || launcher,
     args: [prompt],
     cwd,
     env: {
@@ -175,6 +191,10 @@ async function launchEvent(options, event) {
   });
   const launch = buildLaunchCommand({
     launcher: options.launcher,
+    launcherCommand: resolveLauncherCommand({
+      launcher: options.launcher,
+      launcherCommand: options.launcherCommand
+    }),
     prompt,
     cwd,
     apiKey: options.key,
@@ -202,6 +222,60 @@ async function launchEvent(options, event) {
   });
 }
 
+export function resolveLauncherCommand({
+  launcher,
+  launcherCommand = "",
+  pathEnv = process.env.PATH ?? "",
+  platform = process.platform,
+  homeDir = process.env.HOME || process.env.USERPROFILE || "",
+  exists = existsSync
+}) {
+  if (launcherCommand) return launcherCommand;
+  if (!supportedLaunchers.has(launcher)) {
+    throw new Error(`Unsupported launcher: ${launcher}`);
+  }
+
+  if (isCommandOnPath(launcher, { pathEnv, platform, exists })) return launcher;
+
+  const knownPath = knownLauncherPaths(launcher, platform, homeDir).find((path) =>
+    exists(path)
+  );
+  return knownPath ?? launcher;
+}
+
+function isCommandOnPath(command, { pathEnv, platform, exists }) {
+  const executableNames =
+    platform === "win32" ? [command, `${command}.cmd`, `${command}.exe`] : [command];
+
+  return pathEnv
+    .split(delimiter)
+    .filter(Boolean)
+    .some((pathDirectory) =>
+      executableNames.some((executableName) => exists(join(pathDirectory, executableName)))
+    );
+}
+
+function knownLauncherPaths(launcher, platform, homeDir) {
+  if (platform === "darwin") {
+    const commonBinPaths = [
+      homeDir ? join(homeDir, ".local/bin", launcher) : "",
+      join("/opt/homebrew/bin", launcher),
+      join("/usr/local/bin", launcher)
+    ].filter(Boolean);
+
+    if (launcher === "codex") {
+      return [
+        ...commonBinPaths,
+        "/Applications/Codex.app/Contents/Resources/codex"
+      ];
+    }
+
+    return commonBinPaths;
+  }
+
+  return homeDir ? [join(homeDir, ".local/bin", launcher)] : [];
+}
+
 function normalizeApiUrl(value) {
   return (value || defaultApiUrl).replace(/\/$/, "").replace(/\/mcp$/, "");
 }
@@ -232,6 +306,7 @@ Options:
   --key, -k       Required agent-bound API key.
   --api-url, -u   API base URL. Defaults to ${defaultApiUrl}.
   --launcher, -l  Visible CLI launcher: codex or claude.
+  --command, -c   Optional explicit executable path, e.g. /Applications/Codex.app/Contents/Resources/codex.
   --interval      Poll interval in seconds. Defaults to 10.
   --once          Check once, launch at most one visible session, then exit.
 `;