agent-relay-codex 0.4.29 → 0.4.33

package/README.md

@@ -80,6 +80,7 @@ Run with `AGENT_RELAY_PROFILE=frontend-developer agent-relay-codex start`.
 | `CODEX_THREAD_ID` | — | Pin to a specific thread |
 | `CODEX_APP_SERVER_URL` | `ws://127.0.0.1:4501` | App-server WebSocket URL |
 | `AGENT_RELAY_CODEX_HEADLESS` | — | Set to `1` to run without opening a TUI |
+| `AGENT_RELAY_DISABLED` | — | Set to `1` to bypass Agent Relay hooks and launcher shims |
 
 ### Advanced tuning
 

package/bin/agent-relay-codex.ts

@@ -259,6 +259,75 @@ function findCodexBinary(): string {
   return codex;
 }
 
+function isRelayDisabled(env: Record<string, string | undefined> = process.env): boolean {
+  return env.AGENT_RELAY_DISABLED === "1";
+}
+
+const relayBypassSubcommands = new Set([
+  "a",
+  "app-server",
+  "apply",
+  "cloud",
+  "completion",
+  "debug",
+  "e",
+  "exec",
+  "exec-server",
+  "features",
+  "login",
+  "logout",
+  "mcp",
+  "mcp-server",
+  "plugin",
+  "remote-control",
+  "review",
+  "sandbox",
+  "update",
+]);
+
+function codexSubcommand(args: string[]): string {
+  const optionsWithValues = new Set([
+    "-c",
+    "--config",
+    "-m",
+    "--model",
+    "-p",
+    "--profile",
+    "-s",
+    "--sandbox",
+    "-C",
+    "--cd",
+    "--add-dir",
+  ]);
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index]!;
+    if (arg === "--") return "";
+    if (optionsWithValues.has(arg)) {
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("-")) continue;
+    return arg;
+  }
+
+  return "";
+}
+
+export function shouldBypassRelay(args: string[], env: Record<string, string | undefined> = process.env): boolean {
+  return isRelayDisabled(env) || relayBypassSubcommands.has(codexSubcommand(args));
+}
+
+async function runCodexPassthrough(args: string[]): Promise<void> {
+  const codex = Bun.spawn([findCodexBinary(), ...args], {
+    env: { ...process.env, AGENT_RELAY_DISABLED: "1" },
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit",
+  });
+  process.exit(await codex.exited);
+}
+
 function installMarketplace(quiet = false): void {
   syncInstalledPackage();
 
@@ -1061,6 +1130,7 @@ function uninstall(args: string[] = []): void {
 
 async function main(): Promise<void> {
   const [command, ...args] = process.argv.slice(2);
+  const codexArgs = command ? [command, ...args] : [];
   if (command === "help" || command === "--help" || command === "-h") usage(0);
   if (command === "install") return install(args);
   if (command === "uninstall") return uninstall(args);
@@ -1072,7 +1142,8 @@ async function main(): Promise<void> {
   if (command === "doctor") return doctor();
   if (command === "upgrade") return upgrade(args);
   if (command === "start") return start(args);
-  return start(command ? [command, ...args] : []);
+  if (shouldBypassRelay(codexArgs)) return runCodexPassthrough(codexArgs);
+  return start(codexArgs);
 }
 
 if (import.meta.main) {

package/hooks/session-start.ts

@@ -46,6 +46,11 @@ function outputContext(context: string): never {
   process.exit(0);
 }
 
+function outputContinue(): never {
+  console.log(JSON.stringify({ continue: true }));
+  process.exit(0);
+}
+
 function handshakePath(runtimeDir: string): string {
   return join(runtimeDir, "session-start-handshake.json");
 }
@@ -74,6 +79,10 @@ const project = cwd.split("/").filter(Boolean).at(-1) || "unknown";
 const profile = loadAgentRelayProfile(process.env, { provider: "codex", rig, project });
 const approvalMode = profile.approval ?? parseApprovalMode(process.env.AGENT_RELAY_APPROVAL);
 
+if (process.env.AGENT_RELAY_DISABLED === "1") {
+  outputContinue();
+}
+
 if (process.env.AGENT_RELAY_CODEX_MANAGED === "1") {
   outputContext("Agent Relay is managed by codex-relay for this session; the launcher attached Relay and TUI to the same Codex App Server thread.");
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-codex",
-  "version": "0.4.29",
+  "version": "0.4.33",
   "description": "Codex integration for Agent Relay — auto-registers sessions as agents and enables inter-agent messaging",
   "type": "module",
   "bin": {

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "0.4.29",
+  "version": "0.4.33",
   "description": "Agent Relay integration for Codex sessions",
   "author": {
     "name": "Edin Mujkanovic"