Skip to content

Codex CLI crashes with zsh: trace trap codex during repository analysis on macOS/iTerm2 with Intel CPU #30682

Description

@pkovzz

What version of Codex CLI is running?

0.142.4

What subscription do you have?

ChatGPT subscription, authenticated via ChatGPT auth

Which model were you using?

gpt-5.5

What platform is your computer?

Mac OS 26.5.1 [64-bit], macos-x86_64 git version 2.50.1 (Apple Git-155)

What terminal emulator and version are you using (if applicable)?

iTerm2 3.6.11 Shell: zsh Terminal size: 215x50 Locale: en_US.UTF-8

Codex doctor report

{
  "schemaVersion": 1,
  "generatedAt": "1782799440s since unix epoch",
  "overallStatus": "ok",
  "codexVersion": "0.142.4",
  "checks": {
    "app_server.status": {
      "id": "app_server.status",
      "category": "app-server",
      "status": "ok",
      "summary": "background server is not running",
      "details": {
        "control socket": "/Users/peter/.codex/app-server-control/app-server-control.sock",
        "daemon state dir": "/Users/peter/.codex/app-server-daemon",
        "mode": "ephemeral",
        "pid file": "/Users/peter/.codex/app-server-daemon/app-server.pid (missing)",
        "settings": "/Users/peter/.codex/app-server-daemon/settings.json (missing)",
        "status": "not running",
        "update-loop pid file": "/Users/peter/.codex/app-server-daemon/app-server-updater.pid (missing)"
      },
      "remediation": null,
      "durationMs": 0
    },
    "auth.credentials": {
      "id": "auth.credentials",
      "category": "auth",
      "status": "ok",
      "summary": "auth is configured",
      "details": {
        "auth file": "/Users/peter/.codex/auth.json",
        "auth storage mode": "File",
        "stored API key": "false",
        "stored ChatGPT tokens": "true",
        "stored agent identity": "false",
        "stored auth mode": "chatgpt"
      },
      "remediation": null,
      "durationMs": 0
    },
    "config.load": {
      "id": "config.load",
      "category": "config",
      "status": "ok",
      "summary": "config loaded",
      "details": {
        "CODEX_HOME": "/Users/peter/.codex",
        "config.toml": "/Users/peter/.codex/config.toml",
        "config.toml parse": "ok",
        "cwd": "******",
        "enabled feature flags": "shell_tool, unified_exec, shell_snapshot, terminal_resize_reflow, sqlite, hooks, enable_request_compression, multi_agent, apps, tool_search_always_defer_mcp_tools, tool_suggest, plugins, in_app_browser, browser_use, browser_use_full_cdp_access, browser_use_external, computer_use, plugin_sharing, image_generation, resize_all_images, skill_mcp_dependency_install, mentions_v2, steer, guardian_approval, goals, collaboration_modes, tool_call_mcp_elicitation, personality, fast_mode, tui_app_server, auto_compaction, remote_compaction_v2, workspace_dependencies",
        "feature flag overrides": "none",
        "feature flags enabled": "33",
        "log dir": "/Users/peter/.codex/log",
        "mcp servers": "1",
        "model": "gpt-5.5",
        "model provider": "openai",
        "sqlite home": "/Users/peter/.codex"
      },
      "remediation": null,
      "durationMs": 0
    },
    "git.environment": {
      "id": "git.environment",
      "category": "git",
      "status": "ok",
      "summary": "git version 2.50.1 (Apple Git-155)",
      "details": {
        ".git entry": "directory",
        "PATH git #1": "/usr/bin/git",
        "PATH git entries": "1",
        "git branch": "feat/******",
        "git build options": "git version 2.50.1 (Apple Git-155); cpu: x86_64; no commit associated with this build; sizeof-long: 8; sizeof-size_t: 8; shell-path: /bin/sh; feature: fsmonitor--daemon; libcurl: 8.7.1; zlib: 1.2.12; SHA-1: SHA1_DC; SHA-256: SHA256_BLK",
        "git exec path": "/Library/Developer/CommandLineTools/usr/libexec/git-core",
        "git version": "git version 2.50.1 (Apple Git-155)",
        "repo detected": "true",
        "repo root": "*****",
        "selected git": "/usr/bin/git"
      },
      "remediation": null,
      "durationMs": 316
    },
    "installation": {
      "id": "installation",
      "category": "install",
      "status": "ok",
      "summary": "installation looks consistent",
      "details": {
        "PATH codex #1": "/usr/local/bin/codex",
        "current executable": "/usr/local/bin/codex",
        "install context": "brew",
        "managed by bun": "false",
        "managed by npm": "false",
        "managed package root": "not set"
      },
      "remediation": null,
      "durationMs": 5
    },
    "mcp.config": {
      "id": "mcp.config",
      "category": "mcp",
      "status": "ok",
      "summary": "MCP configuration is locally consistent",
      "details": {
        "configured servers": "1",
        "disabled servers": "0",
        "stdio servers": "1"
      },
      "remediation": null,
      "durationMs": 0
    },
    "network.env": {
      "id": "network.env",
      "category": "network",
      "status": "ok",
      "summary": "network-related environment looks readable",
      "details": {
        "proxy env vars": "none"
      },
      "remediation": null,
      "durationMs": 0
    },
    "network.provider_reachability": {
      "id": "network.provider_reachability",
      "category": "reachability",
      "status": "ok",
      "summary": "active provider endpoints are reachable over HTTP",
      "details": {
        "ChatGPT base URL": "https://chatgpt.com/backend-api/ reachable (HTTP 403)",
        "reachability mode": "ChatGPT auth"
      },
      "remediation": null,
      "durationMs": 345
    },
    "network.websocket_reachability": {
      "id": "network.websocket_reachability",
      "category": "websocket",
      "status": "ok",
      "summary": "Responses WebSocket handshake succeeded",
      "details": {
        "DNS": "2 IPv4, 2 IPv6, first IPv6",
        "auth mode": "chatgpt",
        "connect timeout": "15000 ms",
        "endpoint": "wss://chatgpt.com/backend-api/<redacted>",
        "handshake result": "HTTP 101 Switching Protocols",
        "model provider": "openai",
        "models etag present": "true",
        "provider name": "OpenAI",
        "proxy env vars": "none",
        "reasoning header": "false",
        "server model present": "false",
        "supports websockets": "true",
        "wire API": "responses"
      },
      "remediation": null,
      "durationMs": 739
    },
    "runtime.provenance": {
      "id": "runtime.provenance",
      "category": "runtime",
      "status": "ok",
      "summary": "running brew on macos-x86_64",
      "details": {
        "commit": "unknown",
        "current executable": "/usr/local/bin/codex",
        "install method": "brew",
        "platform": "macos-x86_64",
        "version": "0.142.4"
      },
      "remediation": null,
      "durationMs": 0
    },
    "runtime.search": {
      "id": "runtime.search",
      "category": "search",
      "status": "ok",
      "summary": "search is OK (system)",
      "details": {
        "search command": "rg",
        "search command readiness": "ripgrep 15.1.0",
        "search provider": "system"
      },
      "remediation": null,
      "durationMs": 24
    },
    "sandbox.helpers": {
      "id": "sandbox.helpers",
      "category": "sandbox",
      "status": "ok",
      "summary": "sandbox configuration is readable",
      "details": {
        "approval policy": "OnRequest",
        "codex-linux-sandbox helper": "none",
        "execve wrapper helper": "/Users/peter/.codex/tmp/arg0/codex-arg0ZIi10h/codex-execve-wrapper",
        "filesystem sandbox": "restricted",
        "network sandbox": "restricted"
      },
      "remediation": null,
      "durationMs": 0
    },
    "state.paths": {
      "id": "state.paths",
      "category": "state",
      "status": "ok",
      "summary": "state paths and databases are inspectable",
      "details": {
        "CODEX_HOME": "/Users/peter/.codex (dir)",
        "active rollout files": "96 files, 88281652 total bytes, 919600 average bytes",
        "archived rollout files": "0 files, 0 total bytes, 0 average bytes",
        "goals DB": "/Users/peter/.codex/goals_1.sqlite (file)",
        "goals DB integrity": "ok",
        "log DB": "/Users/peter/.codex/logs_2.sqlite (file)",
        "log DB integrity": "ok",
        "log dir": "/Users/peter/.codex/log (dir)",
        "memories DB": "/Users/peter/.codex/memories_1.sqlite (file)",
        "memories DB integrity": "ok",
        "sqlite home": "/Users/peter/.codex (dir)",
        "state DB": "/Users/peter/.codex/state_5.sqlite (file)",
        "state DB integrity": "ok"
      },
      "remediation": null,
      "durationMs": 1096
    },
    "state.rollout_db_parity": {
      "id": "state.rollout_db_parity",
      "category": "threads",
      "status": "ok",
      "summary": "rollout files and state DB thread inventory agree",
      "details": {
        "default model provider": "openai",
        "rollout DB active files": "96",
        "rollout DB active rows": "96",
        "rollout DB archive mismatches": "0",
        "rollout DB archived files": "0",
        "rollout DB archived rows": "0",
        "rollout DB duplicate DB paths": "0",
        "rollout DB duplicate rollout thread ids": "0",
        "rollout DB malformed file names": "0",
        "rollout DB missing active rows": "0",
        "rollout DB missing archived rows": "0",
        "rollout DB model providers": "openai=96",
        "rollout DB rows": "96",
        "rollout DB scan cap reached": "false",
        "rollout DB scan errors": "0",
        "rollout DB sources": "cli=93, vscode=3",
        "rollout DB stale rows": "0"
      },
      "remediation": null,
      "durationMs": 1085
    },
    "system.environment": {
      "id": "system.environment",
      "category": "system",
      "status": "ok",
      "summary": "OS language en-US",
      "details": {
        "EDITOR": "not set",
        "LANG": "en_US.UTF-8",
        "VISUAL": "not set",
        "os": "Mac OS 26.5.1 [64-bit]",
        "os language": "en-US",
        "os type": "Mac OS",
        "os version": "26.5.1"
      },
      "remediation": null,
      "durationMs": 3
    },
    "terminal.env": {
      "id": "terminal.env",
      "category": "terminal",
      "status": "ok",
      "summary": "terminal metadata was detected",
      "details": {
        "COLORFGBG": "15;0",
        "COLORTERM": "truecolor",
        "TERMINFO_DIRS entry": [
          "/Applications/iTerm.app/Contents/Resources/terminfo (dir)",
          "/usr/share/terminfo (dir)"
        ],
        "TERM_PROGRAM": "iTerm.app",
        "color output": "enabled",
        "effective locale": "en_US.UTF-8",
        "stderr is terminal": "true",
        "stdin is terminal": "true",
        "stdout is terminal": "true",
        "terminal": "iTerm2",
        "terminal size": "215x50",
        "terminal version": "3.6.11"
      },
      "remediation": null,
      "durationMs": 0
    },
    "terminal.title": {
      "id": "terminal.title",
      "category": "title",
      "status": "ok",
      "summary": "terminal title default",
      "details": {
        "terminal title activity": "true",
        "terminal title items": "activity, project-name",
        "terminal title project source": "git repo root",
        "terminal title project value": "data-center-control-p...",
        "terminal title source": "default"
      },
      "remediation": null,
      "durationMs": 0
    },
    "updates.status": {
      "id": "updates.status",
      "category": "updates",
      "status": "ok",
      "summary": "update configuration is locally consistent",
      "details": {
        "cached latest version": "0.142.4",
        "check for update on startup": "true",
        "last checked at": "2026-06-29T10:17:35.272306Z",
        "latest version": "0.142.4",
        "latest version status": "current version is not older",
        "update action": "brew upgrade --cask codex",
        "version cache": "/Users/peter/.codex/version.json"
      },
      "remediation": null,
      "durationMs": 119
    }
  }
}

What issue are you seeing?

Codex CLI crashes while working on a normal repository-inspection task.

I asked Codex:

Can you tell me what the /api/v1/foo/bar endpoint does? Where does it get the data from?

Codex started working and printed:

I’ll trace the route through its handler, service, and data-access layers, then summarize the response and upstream source. Assumption: you mean the endpoint implemented in this repository, not a deployed environment that may differ.

After about 5 seconds, the CLI terminated with:

zsh: trace trap  codex

The terminal then returned to the shell prompt. There was also visible prompt/input corruption after the crash:

peter@MacBookPro project % 9;1;3u

This blocks me from using Codex CLI for repository analysis. The latest version is already installed.

What steps can reproduce the bug?

  1. Open iTerm2 on macOS.
  2. cd into the repository
  3. Start Codex CLI.
  4. Prompt
  5. Wait for Codex to begin tracing the route/handler/service/data-access layers.
  6. After a few seconds, Codex exits and zsh prints >>---> zsh: trace trap codex

What is the expected behavior?

Codex should continue running, inspect the repository, and answer the question about what /api/v1/foo/bar does and where it gets its data.
If an internal error occurs, Codex should report a recoverable error message instead of terminating the process with trace trap.

Additional information

codex doctor --json reports overall status ok.

Relevant environment details from doctor:

  • Codex CLI version: 0.142.4
  • Installed via Homebrew
  • Platform: macos-x86_64
  • OS: Mac OS 26.5.1 [64-bit]
  • Terminal: iTerm2 3.6.11
  • Shell appears to be zsh
  • Auth mode: ChatGPT
  • Model: gpt-5.5
  • Network provider reachability: ok
  • WebSocket handshake: ok
  • Filesystem sandbox: restricted
  • Network sandbox: restricted
  • Approval policy: OnRequest
  • Enabled feature flags include shell_tool, unified_exec, shell_snapshot, terminal_resize_reflow, sqlite, multi_agent, apps, tui_app_server, and others.
  • Update status says current/latest version is 0.142.4.

The failure shown in the terminal is:

zsh: trace trap  codex

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIIssues related to the Codex CLITUIIssues related to the terminal user interface: text input, menus and dialogs, and terminal displaybugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions