esque-bridge 0.4.0 → 0.6.0

package/index.js

@@ -13,6 +13,7 @@
  *      through the configured agent adapter, returning stdout
  *
  *   npx esque-bridge                            # default: claude
+ *   npx esque-bridge --agent codex              # OpenAI Codex (ChatGPT) on this repo
  *   npx esque-bridge --agent aider              # Aider against the current repo
  *   npx esque-bridge --agent custom --cmd 'mycli --prompt {prompt}'
  */
@@ -26,6 +27,10 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+// Windows has no POSIX process groups or `.cmd`-aware spawn, so several
+// process-management paths below branch on this.
+const isWindows = process.platform === 'win32';
+
 // --- Config ---------------------------------------------------------------
 
 const argv = parseArgs(process.argv.slice(2));
@@ -36,13 +41,15 @@ if (argv.help || argv.h) {
 Esque Bridge — pair your phone with a local coding-agent CLI.
 
 USAGE
-  esque-bridge [--agent claude|aider|custom] [--port 3030] [--workdir .]
+  esque-bridge [--agent claude|codex|aider|custom] [--port 3030] [--workdir .]
                [--cmd 'tool --prompt {prompt}'] [--bin <binary>]
                [--timeout 300000]
 
 AGENT ADAPTERS
   claude (default) — uses Claude Code CLI (\`claude --print --output-format json\`).
                      Persists session ids so each conversation continues via --resume.
+  codex           — uses OpenAI Codex CLI (\`codex exec\`, headless, auto-approve).
+                     Drive ChatGPT's coding agent with your ChatGPT plan or API key.
   aider           — uses Aider CLI (\`aider --message ... --yes-always --no-stream\`).
                      Conversation continuity is handled by aider's own .aider.chat.history.md.
   custom          — runs an arbitrary command. Pass --cmd 'tool --prompt {prompt}'
@@ -59,6 +66,7 @@ OPTIONS
 
 PREREQS
   Claude:  npm install -g @anthropic-ai/claude-code   &&   claude /login
+  Codex:   npm install -g @openai/codex               &&   codex login
   Aider:   python -m pip install aider-chat
 
 OUTPUT
@@ -201,6 +209,37 @@ const ADAPTERS = {
     },
   },
 
+  codex: {
+    label: 'Codex',
+    defaultBin: 'codex',
+    install:
+      'npm install -g @openai/codex, then `codex login` (ChatGPT plan or API key).',
+    // `exec` is Codex's non-interactive mode. The bypass flag is Codex's
+    // analogue of Claude's --dangerously-skip-permissions: in headless mode
+    // there's no human to approve file writes / shell commands (incl. the
+    // network installs a fresh scaffold needs), so without it the agent
+    // looks busy but can't touch the disk. Access is already gated by the
+    // pairing secret + the startup workdir confirmation. --skip-git-repo-check
+    // lets it run in a brand-new (not-yet-git) project dir for `fresh` builds.
+    buildArgs(_prompt, _prevSessionId) {
+      return [
+        'exec',
+        '--dangerously-bypass-approvals-and-sandbox',
+        '--skip-git-repo-check',
+      ];
+    },
+    parseOutput(stdout) {
+      // `codex exec` streams its run to stdout and logs to stderr; the trimmed
+      // stdout is the agent's reply. (Codex has no stable resume-by-id we rely
+      // on here, so each turn is self-contained — Esque re-sends repo context.)
+      return {
+        text: stdout.trim() || '(codex returned no output)',
+        cliSessionId: null,
+        isError: false,
+      };
+    },
+  },
+
   aider: {
     label: 'Aider',
     defaultBin: 'aider',
@@ -296,14 +335,19 @@ function runAgent(prompt, esqueSessionId) {
       usesStdin = !argv.some((a) => a.includes(prompt));
     }
 
-    // detached → its own process group so we can kill the WHOLE tree (the
-    // agent can spawn its own subprocesses) on timeout instead of orphaning
-    // zombies.
+    // POSIX: detach into its own process group so we can kill the WHOLE tree
+    // (the agent spawns subprocesses) on timeout instead of orphaning zombies.
+    // Windows: no detach (it would pop a console window) — we kill the tree
+    // via `taskkill /T` instead; and `shell: true` so spawn can resolve the
+    // `.cmd` shims npm installs global bins as (claude.cmd / codex.cmd). Our
+    // built-in adapters pass fixed flag args (the prompt rides via stdin), so
+    // there's no shell-injection surface here.
     const child = spawn(bin, argv, {
       cwd: WORKDIR,
       env: process.env,
       stdio: ['pipe', 'pipe', 'pipe'],
-      detached: true,
+      detached: !isWindows,
+      shell: isWindows,
     });
 
     const MAX_BUF = 16 * 1024 * 1024; // hard cap so a runaway agent can't OOM the bridge
@@ -321,6 +365,22 @@ function runAgent(prompt, esqueSessionId) {
     const rejectOnce = settle(reject);
 
     const killTree = (signal) => {
+      if (isWindows) {
+        // No process groups on Windows; force-kill the whole tree by PID.
+        // Signals don't map, so SIGTERM/SIGKILL both become a /F force-kill.
+        try {
+          spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], {
+            stdio: 'ignore',
+          });
+        } catch {
+          try {
+            child.kill();
+          } catch {
+            /* already gone */
+          }
+        }
+        return;
+      }
       try {
         process.kill(-child.pid, signal);
       } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esque-bridge",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Desktop-side receiver for the Esque Agent mobile app. Pairs your phone with a local coding-agent CLI (Claude Code, Aider, or any custom command) via a tunnel + QR code, so prompts run through your subscription instead of per-token API billing.",
   "bin": {
     "esque-bridge": "index.js"