@respan/cli 0.7.0 → 0.7.2

package/dist/commands/integrate/claude-code.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateClaudeCode extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/claude-code.js

@@ -7,6 +7,37 @@ class IntegrateClaudeCode extends BaseCommand {
         const { flags } = await this.parse(IntegrateClaudeCode);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'both');
+            const doLocal = scope === 'local' || scope === 'both';
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove the Stop hook entry from global settings
+                const globalSettingsPath = expandHome('~/.claude/settings.json');
+                const globalSettings = readJsonFile(globalSettingsPath);
+                const hooksSection = (globalSettings.hooks || {});
+                if (Array.isArray(hooksSection.Stop)) {
+                    hooksSection.Stop = hooksSection.Stop.filter((entry) => {
+                        const inner = Array.isArray(entry.hooks)
+                            ? entry.hooks
+                            : [];
+                        return !inner.some((h) => typeof h.command === 'string' &&
+                            (h.command.includes('respan') || h.command.includes('hook.py') || h.command.includes('claude-code')));
+                    });
+                }
+                const merged = deepMerge(globalSettings, { hooks: hooksSection });
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${globalSettingsPath}`);
+                    this.log(JSON.stringify(merged, null, 2));
+                }
+                else {
+                    writeJsonFile(globalSettingsPath, merged);
+                    this.log(`Removed hook entry: ${globalSettingsPath}`);
+                }
+                this.log('Claude Code tracing disabled. Run "respan integrate claude-code" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const baseUrl = flags['base-url'];
@@ -15,11 +46,8 @@ class IntegrateClaudeCode extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            // Claude Code default: both global + local
-            const scope = resolveScope(flags, 'both');
+            // Claude Code default: both global + local.
             const doGlobal = scope === 'global' || scope === 'both';
-            const doLocal = scope === 'local' || scope === 'both';
             // ── Global: hook script + registration ────────────────────────
             if (doGlobal) {
                 // 1. Write JS hook script (no Python dependency needed)
@@ -165,9 +193,11 @@ them to Respan as structured spans (chat, tool, thinking).
 Scope:
   --global   Install hook script + register in ~/.claude/settings.json
   --local    Write credentials + enable flag to .claude/settings.local.json
-  (default)  Both: install hook globally + enable for current project`;
+
+Default behavior installs the global hook and writes local project config.`;
 IntegrateClaudeCode.examples = [
     'respan integrate claude-code',
+    'respan integrate claude-code --disable',
     'respan integrate claude-code --global',
     'respan integrate claude-code --local --project-id my-project',
     'respan integrate claude-code --attrs \'{"env":"prod"}\'',

package/dist/commands/integrate/codex-cli.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateCodexCli extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/codex-cli.js

@@ -6,6 +6,26 @@ class IntegrateCodexCli extends BaseCommand {
         const { flags } = await this.parse(IntegrateCodexCli);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove the notify line from ~/.codex/config.toml
+                const configPath = expandHome('~/.codex/config.toml');
+                const existing = readTextFile(configPath);
+                const lines = existing.split('\n');
+                const filtered = lines.filter((line) => !/^\s*notify\s*=/.test(line) && !line.includes('respan integrate codex-cli'));
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${configPath}`);
+                    this.log(filtered.join('\n'));
+                }
+                else {
+                    writeTextFile(configPath, filtered.join('\n'));
+                    this.log(`Removed notify hook: ${configPath}`);
+                }
+                this.log('Codex CLI tracing disabled. Run "respan integrate codex-cli" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const projectId = flags['project-id'];
@@ -13,7 +33,6 @@ class IntegrateCodexCli extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
             // Codex CLI default: both global + local
             const scope = resolveScope(flags, 'both');
             const doGlobal = scope === 'global' || scope === 'both';
@@ -155,9 +174,11 @@ them to Respan as structured spans (chat, tool, reasoning).
 Scope:
   --global   Install hook script + register notify in ~/.codex/config.toml
   --local    Write .codex/respan.json with customer_id, span_name, etc.
-  (default)  Both: install hook globally + config for current project`;
+
+Default behavior installs the global notify hook and writes local project config.`;
 IntegrateCodexCli.examples = [
     'respan integrate codex-cli',
+    'respan integrate codex-cli --disable',
     'respan integrate codex-cli --global',
     'respan integrate codex-cli --local --customer-id frank',
     'respan integrate codex-cli --attrs \'{"env":"prod"}\'',

package/dist/commands/integrate/gemini-cli.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateGeminiCli extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/gemini-cli.js

@@ -7,6 +7,40 @@ class IntegrateGeminiCli extends BaseCommand {
         const { flags } = await this.parse(IntegrateGeminiCli);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'global');
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                // Remove respan hook entries from settings.json
+                const settingsPath = scope === 'global'
+                    ? expandHome('~/.gemini/settings.json')
+                    : path.join(findProjectRoot(), '.gemini', 'settings.json');
+                const existing = readJsonFile(settingsPath);
+                const hooksSection = (existing.hooks || {});
+                for (const eventName of ['AfterModel', 'BeforeTool', 'AfterTool']) {
+                    if (!Array.isArray(hooksSection[eventName]))
+                        continue;
+                    hooksSection[eventName] = hooksSection[eventName].filter((entry) => {
+                        const inner = Array.isArray(entry.hooks)
+                            ? entry.hooks
+                            : [];
+                        return !inner.some((h) => typeof h.command === 'string' &&
+                            (h.command.includes('respan') || h.command.includes('gemini-cli')));
+                    });
+                }
+                const merged = { ...existing, hooks: hooksSection };
+                if (dryRun) {
+                    this.log(`[dry-run] Would update: ${settingsPath}`);
+                    this.log(JSON.stringify(merged, null, 2));
+                }
+                else {
+                    writeJsonFile(settingsPath, merged);
+                    this.log(`Removed hook entries: ${settingsPath}`);
+                }
+                this.log('Gemini CLI tracing disabled. Run "respan integrate gemini-cli" to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             // Verify the user is authenticated (key is read by hook from ~/.respan/)
             this.resolveApiKey();
             const projectId = flags['project-id'];
@@ -14,8 +48,6 @@ class IntegrateGeminiCli extends BaseCommand {
             const spanName = flags['span-name'];
             const workflowName = flags['workflow-name'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'global');
             // ── 1. Install hook script ──────────────────────────────────
             const hookDir = expandHome('~/.respan/hooks');
             const hookPath = `${hookDir}/gemini-cli.cjs`;
@@ -142,10 +174,10 @@ Scope:
   --global   Write to ~/.gemini/settings.json (default)
   --local    Write to .gemini/settings.json in project root
 
-Note: Gemini CLI ignores workspace-level telemetry settings, so
---global is the default.`;
+Gemini CLI ignores workspace-level telemetry settings, so --global is the default.`;
 IntegrateGeminiCli.examples = [
     'respan integrate gemini-cli',
+    'respan integrate gemini-cli --disable',
     'respan integrate gemini-cli --local',
     'respan integrate gemini-cli --project-id my-project --attrs \'{"env":"prod"}\'',
     'respan integrate gemini-cli --dry-run',

package/dist/commands/integrate/opencode.d.ts

@@ -5,6 +5,8 @@ export default class IntegrateOpencode extends BaseCommand {
     static flags: {
         local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        enable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disable: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         attrs: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/integrate/opencode.js

@@ -1,3 +1,4 @@
+import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execSync } from 'node:child_process';
 import { BaseCommand } from '../../lib/base-command.js';
@@ -7,12 +8,33 @@ class IntegrateOpencode extends BaseCommand {
         const { flags } = await this.parse(IntegrateOpencode);
         this.globalFlags = flags;
         try {
+            const dryRun = flags['dry-run'];
+            const scope = resolveScope(flags, 'local');
+            // ── Disable mode ─────────────────────────────────────────────
+            if (flags.disable) {
+                const pluginPath = scope === 'global'
+                    ? expandHome('~/.config/opencode/plugins/otel.json')
+                    : path.join(findProjectRoot(), '.opencode', 'plugins', 'otel.json');
+                if (dryRun) {
+                    this.log(`[dry-run] Would remove: ${pluginPath}`);
+                }
+                else {
+                    try {
+                        fs.unlinkSync(pluginPath);
+                        this.log(`Removed plugin config: ${pluginPath}`);
+                    }
+                    catch {
+                        this.log(`No plugin config found at: ${pluginPath}`);
+                    }
+                }
+                this.log('OpenCode tracing disabled. Run with --enable to re-enable.');
+                return;
+            }
+            // ── Enable mode (default) ────────────────────────────────────
             const apiKey = this.resolveApiKey();
             const baseUrl = (flags['base-url']).replace(/\/+$/, '');
             const projectId = flags['project-id'];
             const attrs = parseAttrs(flags.attrs);
-            const dryRun = flags['dry-run'];
-            const scope = resolveScope(flags, 'local');
             // ── 1. Install opencode-otel (always global) ─────────────────
             if (dryRun) {
                 this.log('[dry-run] Would run: npm install -g opencode-otel');
@@ -89,6 +111,7 @@ Scope:
   The opencode-otel package is always installed globally.`;
 IntegrateOpencode.examples = [
     'respan integrate opencode',
+    'respan integrate opencode --disable',
     'respan integrate opencode --global',
     'respan integrate opencode --project-id my-project --attrs \'{"env":"prod"}\'',
     'respan integrate opencode --dry-run',

package/dist/hooks/claude-code.cjs

@@ -280,6 +280,7 @@ function stringToSpanId(s) {
 function toOtlpPayload(spans) {
   const otlpSpans = spans.map((span) => {
     const attrs = {};
+    if (span.session_identifier) attrs["respan.sessions.session_identifier"] = span.session_identifier;
     if (span.thread_identifier) attrs["respan.threads.thread_identifier"] = span.thread_identifier;
     if (span.customer_identifier) attrs["respan.customer_params.customer_identifier"] = span.customer_identifier;
     if (span.span_workflow_name) attrs["traceloop.workflow.name"] = span.span_workflow_name;
@@ -340,7 +341,7 @@ function toOtlpPayload(spans) {
         })
       },
       scopeSpans: [{
-        scope: { name: "respan-cli-hooks", version: "0.7.0" },
+        scope: { name: "respan-cli-hooks", version: "0.7.1" },
         spans: otlpSpans
       }]
     }]
@@ -599,6 +600,7 @@ function createSpans(sessionId, turnNum, userMsg, assistantMsgs, toolResults, co
   const rootSpanId = `claudecode_${traceUniqueId}_root`;
   spans.push({
     trace_unique_id: traceUniqueId,
+    session_identifier: threadId,
     thread_identifier: threadId,
     customer_identifier: customerId,
     span_unique_id: rootSpanId,

package/dist/hooks/claude-code.js

@@ -248,6 +248,7 @@ function createSpans(sessionId, turnNum, userMsg, assistantMsgs, toolResults, co
     const rootSpanId = `claudecode_${traceUniqueId}_root`;
     spans.push({
         trace_unique_id: traceUniqueId,
+        session_identifier: threadId,
         thread_identifier: threadId,
         customer_identifier: customerId,
         span_unique_id: rootSpanId,

package/dist/hooks/codex-cli.cjs

@@ -26,6 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var fs2 = __toESM(require("node:fs"), 1);
 var os2 = __toESM(require("node:os"), 1);
 var path2 = __toESM(require("node:path"), 1);
+var import_node_child_process = require("node:child_process");
 
 // src/hooks/shared.ts
 var fs = __toESM(require("node:fs"), 1);
@@ -279,6 +280,7 @@ function stringToSpanId(s) {
 function toOtlpPayload(spans) {
   const otlpSpans = spans.map((span) => {
     const attrs = {};
+    if (span.session_identifier) attrs["respan.sessions.session_identifier"] = span.session_identifier;
     if (span.thread_identifier) attrs["respan.threads.thread_identifier"] = span.thread_identifier;
     if (span.customer_identifier) attrs["respan.customer_params.customer_identifier"] = span.customer_identifier;
     if (span.span_workflow_name) attrs["traceloop.workflow.name"] = span.span_workflow_name;
@@ -339,7 +341,7 @@ function toOtlpPayload(spans) {
         })
       },
       scopeSpans: [{
-        scope: { name: "respan-cli-hooks", version: "0.7.0" },
+        scope: { name: "respan-cli-hooks", version: "0.7.1" },
         spans: otlpSpans
       }]
     }]
@@ -572,6 +574,7 @@ function createSpans(sessionId, turnNum, turn, config) {
   const rootSpanId = `codexcli_${traceUniqueId}_root`;
   spans.push({
     trace_unique_id: traceUniqueId,
+    session_identifier: threadId,
     thread_identifier: threadId,
     customer_identifier: customerId,
     span_unique_id: rootSpanId,
@@ -699,50 +702,18 @@ function findLatestSessionFile() {
     return null;
   }
 }
-async function main() {
+async function mainWorker() {
   const scriptStart = Date.now();
-  debug("Codex hook started");
-  if (process.argv.length < 3) {
-    debug("No argument provided (expected JSON payload in argv[2])");
-    process.exit(0);
-  }
-  let payload;
-  try {
-    payload = JSON.parse(process.argv[2]);
-  } catch (e) {
-    debug(`Invalid JSON in argv[2]: ${e}`);
-    process.exit(0);
-  }
-  const eventType = String(payload.type ?? "");
-  if (eventType !== "agent-turn-complete") {
-    debug(`Ignoring event type: ${eventType}`);
-    process.exit(0);
-  }
-  let sessionId = String(payload["thread-id"] ?? "");
-  if (!sessionId) {
-    debug("No thread-id in notify payload");
-    process.exit(0);
-  }
-  debug(`Processing notify: type=${eventType}, session=${sessionId}`);
+  debug("Worker started");
+  const sessionId = process.env._RESPAN_CODEX_SESSION;
+  const sessionFile = process.env._RESPAN_CODEX_FILE;
+  const cwd = process.env._RESPAN_CODEX_CWD ?? "";
   const creds = resolveCredentials();
   if (!creds) {
-    log("ERROR", "No API key found. Run: respan auth login");
-    process.exit(0);
-  }
-  let sessionFile = findSessionFile(sessionId);
-  if (!sessionFile) {
-    const latest = findLatestSessionFile();
-    if (latest) {
-      sessionId = latest.sessionId;
-      sessionFile = latest.sessionFile;
-    } else {
-      debug("No session file found");
-      process.exit(0);
-    }
+    log("ERROR", "No API key");
+    return;
   }
-  const cwd = String(payload.cwd ?? "");
   const config = cwd ? loadRespanConfig(path2.join(cwd, ".codex", "respan.json")) : null;
-  if (config) debug(`Loaded respan.json config from ${cwd}`);
   const maxAttempts = 3;
   let turns = 0;
   try {
@@ -774,20 +745,73 @@ async function main() {
       }
       if (turns > 0) break;
       if (attempt < maxAttempts - 1) {
-        const delay = 500 * (attempt + 1);
-        debug(`No turns processed (attempt ${attempt + 1}/${maxAttempts}), retrying in ${delay}ms...`);
-        await new Promise((r) => setTimeout(r, delay));
+        await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
       }
     }
     const duration = (Date.now() - scriptStart) / 1e3;
     log("INFO", `Processed ${turns} turns in ${duration.toFixed(1)}s`);
-    if (duration > 180) log("WARN", `Hook took ${duration.toFixed(1)}s (>3min)`);
   } catch (e) {
     log("ERROR", `Failed to process session: ${e}`);
-    if (DEBUG_MODE) debug(String(e.stack ?? e));
   }
 }
-main().catch((e) => {
-  log("ERROR", `Hook crashed: ${e}`);
-  process.exit(1);
-});
+function main() {
+  if (process.env._RESPAN_CODEX_WORKER === "1") {
+    mainWorker().catch((e) => log("ERROR", `Worker crashed: ${e}`));
+    return;
+  }
+  debug("Codex hook started");
+  if (process.argv.length < 3) {
+    debug("No argument provided");
+    process.exit(0);
+  }
+  let payload;
+  try {
+    payload = JSON.parse(process.argv[2]);
+  } catch (e) {
+    debug(`Invalid JSON in argv[2]: ${e}`);
+    process.exit(0);
+  }
+  const eventType = String(payload.type ?? "");
+  if (eventType !== "agent-turn-complete") {
+    debug(`Ignoring event type: ${eventType}`);
+    process.exit(0);
+  }
+  let sessionId = String(payload["thread-id"] ?? "");
+  if (!sessionId) {
+    debug("No thread-id in notify payload");
+    process.exit(0);
+  }
+  let sessionFile = findSessionFile(sessionId);
+  if (!sessionFile) {
+    const latest = findLatestSessionFile();
+    if (latest) {
+      sessionId = latest.sessionId;
+      sessionFile = latest.sessionFile;
+    } else {
+      debug("No session file found");
+      process.exit(0);
+    }
+  }
+  const cwd = String(payload.cwd ?? "");
+  debug(`Forking worker for session: ${sessionId}`);
+  try {
+    const scriptPath = __filename || process.argv[1];
+    const child = (0, import_node_child_process.execFile)("node", [scriptPath], {
+      env: {
+        ...process.env,
+        _RESPAN_CODEX_WORKER: "1",
+        _RESPAN_CODEX_SESSION: sessionId,
+        _RESPAN_CODEX_FILE: sessionFile,
+        _RESPAN_CODEX_CWD: cwd
+      },
+      stdio: "ignore",
+      detached: true
+    });
+    child.unref();
+    debug("Worker launched");
+  } catch (e) {
+    log("ERROR", `Failed to fork worker: ${e}`);
+  }
+  process.exit(0);
+}
+main();

package/dist/hooks/codex-cli.js

@@ -16,6 +16,7 @@
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { execFile } from 'node:child_process';
 import { initLogging, log, debug, resolveCredentials, loadRespanConfig, loadState, saveState, acquireLock, sendSpans, addDefaultsToAll, resolveSpanFields, buildMetadata, nowISO, latencySeconds, truncate, } from './shared.js';
 // ── Config ────────────────────────────────────────────────────────
 const STATE_DIR = path.join(os.homedir(), '.codex', 'state');
@@ -221,6 +222,7 @@ function createSpans(sessionId, turnNum, turn, config) {
     const rootSpanId = `codexcli_${traceUniqueId}_root`;
     spans.push({
         trace_unique_id: traceUniqueId,
+        session_identifier: threadId,
         thread_identifier: threadId,
         customer_identifier: customerId,
         span_unique_id: rootSpanId,
@@ -363,57 +365,18 @@ function findLatestSessionFile() {
     }
 }
 // ── Main ──────────────────────────────────────────────────────────
-async function main() {
+async function mainWorker() {
     const scriptStart = Date.now();
-    debug('Codex hook started');
-    // Parse notify payload from argv[2] (argv[0]=node, argv[1]=script)
-    if (process.argv.length < 3) {
-        debug('No argument provided (expected JSON payload in argv[2])');
-        process.exit(0);
-    }
-    let payload;
-    try {
-        payload = JSON.parse(process.argv[2]);
-    }
-    catch (e) {
-        debug(`Invalid JSON in argv[2]: ${e}`);
-        process.exit(0);
-    }
-    const eventType = String(payload.type ?? '');
-    if (eventType !== 'agent-turn-complete') {
-        debug(`Ignoring event type: ${eventType}`);
-        process.exit(0);
-    }
-    let sessionId = String(payload['thread-id'] ?? '');
-    if (!sessionId) {
-        debug('No thread-id in notify payload');
-        process.exit(0);
-    }
-    debug(`Processing notify: type=${eventType}, session=${sessionId}`);
+    debug('Worker started');
+    const sessionId = process.env._RESPAN_CODEX_SESSION;
+    const sessionFile = process.env._RESPAN_CODEX_FILE;
+    const cwd = process.env._RESPAN_CODEX_CWD ?? '';
     const creds = resolveCredentials();
     if (!creds) {
-        log('ERROR', 'No API key found. Run: respan auth login');
-        process.exit(0);
-    }
-    // Find session file
-    let sessionFile = findSessionFile(sessionId);
-    if (!sessionFile) {
-        const latest = findLatestSessionFile();
-        if (latest) {
-            sessionId = latest.sessionId;
-            sessionFile = latest.sessionFile;
-        }
-        else {
-            debug('No session file found');
-            process.exit(0);
-        }
+        log('ERROR', 'No API key');
+        return;
     }
-    // Load config
-    const cwd = String(payload.cwd ?? '');
     const config = cwd ? loadRespanConfig(path.join(cwd, '.codex', 'respan.json')) : null;
-    if (config)
-        debug(`Loaded respan.json config from ${cwd}`);
-    // Process with retry
     const maxAttempts = 3;
     let turns = 0;
     try {
@@ -447,23 +410,80 @@ async function main() {
             if (turns > 0)
                 break;
             if (attempt < maxAttempts - 1) {
-                const delay = 500 * (attempt + 1);
-                debug(`No turns processed (attempt ${attempt + 1}/${maxAttempts}), retrying in ${delay}ms...`);
-                await new Promise((r) => setTimeout(r, delay));
+                await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
             }
         }
         const duration = (Date.now() - scriptStart) / 1000;
         log('INFO', `Processed ${turns} turns in ${duration.toFixed(1)}s`);
-        if (duration > 180)
-            log('WARN', `Hook took ${duration.toFixed(1)}s (>3min)`);
     }
     catch (e) {
         log('ERROR', `Failed to process session: ${e}`);
-        if (DEBUG_MODE)
-            debug(String(e.stack ?? e));
     }
 }
-main().catch((e) => {
-    log('ERROR', `Hook crashed: ${e}`);
-    process.exit(1);
-});
+function main() {
+    // Worker mode: re-invoked as detached subprocess
+    if (process.env._RESPAN_CODEX_WORKER === '1') {
+        mainWorker().catch((e) => log('ERROR', `Worker crashed: ${e}`));
+        return;
+    }
+    debug('Codex hook started');
+    if (process.argv.length < 3) {
+        debug('No argument provided');
+        process.exit(0);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(process.argv[2]);
+    }
+    catch (e) {
+        debug(`Invalid JSON in argv[2]: ${e}`);
+        process.exit(0);
+    }
+    const eventType = String(payload.type ?? '');
+    if (eventType !== 'agent-turn-complete') {
+        debug(`Ignoring event type: ${eventType}`);
+        process.exit(0);
+    }
+    let sessionId = String(payload['thread-id'] ?? '');
+    if (!sessionId) {
+        debug('No thread-id in notify payload');
+        process.exit(0);
+    }
+    // Find session file
+    let sessionFile = findSessionFile(sessionId);
+    if (!sessionFile) {
+        const latest = findLatestSessionFile();
+        if (latest) {
+            sessionId = latest.sessionId;
+            sessionFile = latest.sessionFile;
+        }
+        else {
+            debug('No session file found');
+            process.exit(0);
+        }
+    }
+    // Fork self as detached worker so Codex CLI doesn't block
+    const cwd = String(payload.cwd ?? '');
+    debug(`Forking worker for session: ${sessionId}`);
+    try {
+        const scriptPath = __filename || process.argv[1];
+        const child = execFile('node', [scriptPath], {
+            env: {
+                ...process.env,
+                _RESPAN_CODEX_WORKER: '1',
+                _RESPAN_CODEX_SESSION: sessionId,
+                _RESPAN_CODEX_FILE: sessionFile,
+                _RESPAN_CODEX_CWD: cwd,
+            },
+            stdio: 'ignore',
+            detached: true,
+        });
+        child.unref();
+        debug('Worker launched');
+    }
+    catch (e) {
+        log('ERROR', `Failed to fork worker: ${e}`);
+    }
+    process.exit(0);
+}
+main();