openai / openai/codex

`/side` panics when fork occurs during a tool call

Open
#42,163 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug CLI session tool-calls TUI
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

What version of Codex CLI is running?

~0.151.0 - main's d58d0e5841e0de08e251673db2d5af8cf3a1ad51 (built in debug mode)

What subscription do you have?

Pro

Which model were you using?

gpt-5.6-sol

What platform is your computer?

Darwin 24.6.0 arm64 arm

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

Ghostty

Codex doctor report
{
  "schemaVersion": 1,
  "generatedAt": "1788310718s since unix epoch",
  "overallStatus": "warning",
  "codexVersion": "0.151.0",
  "checks": {
    "app_server.status": {
      "id": "app_server.status",
      "category": "app-server",
      "status": "ok",
      "summary": "background server is running",
      "details": {
        "app-server version": "0.149.1",
        "control socket": "~/.codex/app-server-control/app-server-control.sock",
        "daemon state dir": "~/.codex/app-server-daemon",
        "mode": "ephemeral",
        "pid file": "~/.codex/app-server-daemon/app-server.pid (file)",
        "settings": "~/.codex/app-server-daemon/settings.json (missing)",
        "status": "running",
        "update-loop pid file": "~/.codex/app-server-daemon/app-server-updater.pid (missing)"
      },
      "remediation": null,
      "durationMs": 339
    },
    "auth.credentials": {
      "id": "auth.credentials",
      "category": "auth",
      "status": "ok",
      "summary": "auth is configured",
      "details": {
        "auth file": "~/.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": "~/.codex",
        "config.toml": "~/.codex/config.toml",
        "config.toml parse": "ok",
        "cwd": "~/projects/codex",
        "enabled feature flags": "shell_tool, view_image, unified_exec, unified_exec_zsh_fork, shell_snapshot, content_item_kinds, code_mode_host, terminal_resize_reflow, sqlite, hooks, enable_request_compression, unbounded_connection_retries, multi_agent, tool_search_always_defer_mcp_tools, tool_suggest, plugins, in_app_browser, in_app_chat, in_app_dictation, in_app_local_automation, in_app_updates, browser_use, browser_use_full_cdp_access, browser_use_external, computer_use, remote_plugin, plugin_sharing, image_generation, resize_all_images, item_ids, skill_mcp_dependency_install, skill_search, mentions_v2, steer, default_mode_request_user_input, guardian_approval, goals, collaboration_modes, tool_call_mcp_elicitation, auth_elicitation, personality, fast_mode, tui_app_server, remote_compaction_v2, compaction_image_budget, workspace_dependencies",
        "feature flag overrides": "apps=false, default_mode_request_user_input=true",
        "feature flags enabled": "46",
        "log dir": "~/.codex/log",
        "mcp servers": "2",
        "model": "gpt-5.6-sol",
        "model provider": "openai",
        "sqlite home": "~/.codex"
      },
      "remediation": null,
      "durationMs": 0
    },
    "desktop.app.version": {
      "id": "desktop.app.version",
      "category": "desktop",
      "status": "ok",
      "summary": "the desktop application is installed",
      "details": {
        "log directory": "$HOME/Library/Logs/com.openai.codex",
        "running": "false",
        "version": "26.820.60940"
      },
      "remediation": null,
      "durationMs": 0
    },
    "desktop.app_server.handshake": {
      "id": "desktop.app_server.handshake",
      "category": "desktop",
      "status": "ok",
      "summary": "the desktop application is not running",
      "details": {},
      "remediation": null,
      "durationMs": 0
    },
    "desktop.security.enforcement": {
      "id": "desktop.security.enforcement",
      "category": "desktop",
      "status": "warning",
      "summary": "recent macos security enforcement history was unavailable",
      "details": {},
      "remediation": "check access to macos unified security logs and rerun codex doctor",
      "durationMs": 0
    },
    "git.environment": {
      "id": "git.environment",
      "category": "git",
      "status": "ok",
      "summary": "git version 2.54.0",
      "details": {
        ".git entry": "directory",
        "PATH git #1": "/opt/homebrew/bin/git",
        "PATH git #2": "/usr/bin/git",
        "PATH git entries": "2",
        "git branch": "main",
        "git build options": "git version 2.54.0; cpu: arm64; no commit associated with this build; sizeof-long: 8; sizeof-size_t: 8; shell-path: /bin/sh; rust: disabled; feature: fsmonitor--daemon; gettext: enabled; libcurl: 8.7.1; zlib: 1.2.12; SHA-1: SHA1_DC; SHA-256: SHA256_BLK; default-ref-format: files; default-hash: sha1",
        "git exec path": "/opt/homebrew/opt/git/libexec/git-core",
        "git version": "git version 2.54.0",
        "repo detected": "true",
        "repo root": "~/projects/codex",
        "selected git": "/opt/homebrew/bin/git"
      },
      "remediation": null,
      "durationMs": 269
    },
    "installation": {
      "id": "installation",
      "category": "install",
      "status": "ok",
      "summary": "installation looks consistent",
      "details": {
        "PATH codex #1": "~/.local/bin/codex",
        "current executable": "~/.local/bin/codex",
        "install context": "standalone (unix, package ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin, bin ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/bin, resources ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/codex-resources, path ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/codex-path)",
        "managed by bun": "false",
        "managed by npm": "false",
        "managed by pnpm": "false",
        "managed package root": "not set"
      },
      "remediation": null,
      "durationMs": 4
    },
    "mcp.config": {
      "id": "mcp.config",
      "category": "mcp",
      "status": "ok",
      "summary": "MCP configuration is locally consistent",
      "details": {
        "configured servers": "2",
        "disabled servers": "1",
        "stdio servers": "2"
      },
      "remediation": null,
      "durationMs": 0
    },
    "network.env": {
      "id": "network.env",
      "category": "network",
      "status": "ok",
      "summary": "network-related environment looks readable",
      "details": {
        "managed proxy": "not configured",
        "proxy env vars": "none",
        "respect system proxy": "disabled",
        "system proxy": "direct"
      },
      "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 inference URL": "https://chatgpt.com/backend-api/<redacted> reachable (HTTP 405)",
        "desktop assets CDN": "https://chatgpt.com/backend-api/<redacted> reachable (HTTP 200)",
        "reachability mode": "ChatGPT auth"
      },
      "remediation": null,
      "durationMs": 440
    },
    "network.websocket_reachability": {
      "id": "network.websocket_reachability",
      "category": "websocket",
      "status": "ok",
      "summary": "Responses WebSocket handshake succeeded",
      "details": {
        "DNS": "2 IPv4, 0 IPv6, first IPv4",
        "auth mode": "chatgpt",
        "connect timeout": "15000 ms",
        "endpoint": "wss://chatgpt.com/backend-api/<redacted>",
        "handshake result": "HTTP 101 Switching Protocols",
        "model provider": "openai",
        "provider name": "OpenAI",
        "proxy env vars": "none",
        "reasoning header": "false",
        "server model present": "false",
        "supports websockets": "true",
        "wire API": "responses"
      },
      "remediation": null,
      "durationMs": 976
    },
    "runtime.provenance": {
      "id": "runtime.provenance",
      "category": "runtime",
      "status": "ok",
      "summary": "running standalone on macos-aarch64",
      "details": {
        "commit": "unknown",
        "current executable": "~/.local/bin/codex",
        "install method": "standalone (unix, package ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin, bin ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/bin, resources ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/codex-resources, path ~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/codex-path)",
        "platform": "macos-aarch64",
        "version": "0.151.0"
      },
      "remediation": null,
      "durationMs": 0
    },
    "runtime.search": {
      "id": "runtime.search",
      "category": "search",
      "status": "ok",
      "summary": "search is OK (bundled)",
      "details": {
        "search command": "~/.codex/packages/standalone/releases/0.151.0-aarch64-apple-darwin/codex-path/rg",
        "search command readiness": "file exists",
        "search provider": "bundled"
      },
      "remediation": null,
      "durationMs": 0
    },
    "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": "~/.codex/tmp/arg0/codex-arg0Hhb6dF/codex-execve-wrapper",
        "filesystem sandbox": "restricted",
        "network sandbox": "enabled"
      },
      "remediation": null,
      "durationMs": 0
    },
    "security.endpoint": {
      "id": "security.endpoint",
      "category": "security",
      "status": "ok",
      "summary": "no supported endpoint protection detected",
      "details": {
        "endpoint products": "none detected"
      },
      "remediation": null,
      "durationMs": 110
    },
    "state.paths": {
      "id": "state.paths",
      "category": "state",
      "status": "ok",
      "summary": "state paths and databases are inspectable",
      "details": {
        "CODEX_HOME": "~/.codex (dir)",
        "active rollout files": "7946 files, 19069152476 total bytes, 2399842 average bytes",
        "archived rollout files": "44 files, 43340695 total bytes, 985015 average bytes",
        "goals DB": "~/.codex/goals_1.sqlite (file)",
        "goals DB integrity": "ok",
        "log DB": "~/.codex/logs_2.sqlite (file)",
        "log DB integrity": "ok",
        "log dir": "~/.codex/log (dir)",
        "memories DB": "~/.codex/memories_1.sqlite (file)",
        "memories DB integrity": "ok",
        "queue DB": "~/.codex/queue_1.sqlite (file)",
        "queue DB integrity": "ok",
        "sqlite home": "~/.codex (dir)",
        "standalone release cache": "4 entries in ~/.codex/packages/standalone/releases",
        "state DB": "~/.codex/state_5.sqlite (file)",
        "state DB integrity": "ok",
        "thread history DB": "~/.codex/thread_history_1.sqlite (file)",
        "thread history DB integrity": "ok"
      },
      "remediation": null,
      "durationMs": 7072
    },
    "state.rollout_db_parity": {
      "id": "state.rollout_db_parity",
      "category": "threads",
      "status": "warning",
      "summary": "rollout files and state DB thread inventory differ",
      "details": {
        "default model provider": "openai",
        "rollout DB active files": "7946",
        "rollout DB active rows": "8544",
        "rollout DB archive mismatches": "0",
        "rollout DB archived files": "44",
        "rollout DB archived rows": "44",
        "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=8588",
        "rollout DB rows": "8588",
        "rollout DB scan cap reached": "false",
        "rollout DB scan errors": "0",
        "rollout DB sources": "subagent:thread_spawn=3685, cli=2624, subagent:other=1241, exec=455, vscode=370, subagent:review=213",
        "rollout DB stale row sample": [
          "~/.codex/sessions/2026/08/01/rollout-2026-08-01T00-08-31-019fb89c-cba7-77d0-9d90-b9e88c4c7c0b.jsonl",
          "~/.codex/sessions/2026/08/01/rollout-2026-08-01T00-23-56-019fb8aa-e867-7b73-b33b-832b129b4c19.jsonl",
          "~/.codex/sessions/2026/08/01/rollout-2026-08-01T00-32-10-019fb8b2-7499-7280-b33b-134ff61faf44.jsonl",
          "~/.codex/sessions/2026/08/01/rollout-2026-08-01T00-37-37-019fb8b7-6fdb-73d1-a01f-99148f13298b.jsonl",
          "~/.codex/sessions/2026/08/01/rollout-2026-08-01T00-45-06-019fb8be-4aa5-7a52-9828-b72d85771489.jsonl"
        ],
        "rollout DB stale rows": "598"
      },
      "issues": [
        {
          "severity": "warning",
          "cause": "state DB rows point at missing or unusable rollout files",
          "measured": "598 stale rows",
          "expected": "every state DB rollout path is a file on disk",
          "remedy": null,
          "fields": []
        }
      ],
      "remediation": null,
      "durationMs": 4650
    },
    "system.disk": {
      "id": "system.disk",
      "category": "disk",
      "status": "ok",
      "summary": "sufficient free disk space (28.0 GiB)",
      "details": {
        "CODEX_HOME available": "28.0 GiB",
        "failure threshold": "1.0 GiB",
        "warning threshold": "5.0 GiB",
        "worktree available": "28.0 GiB"
      },
      "remediation": null,
      "durationMs": 0
    },
    "system.environment": {
      "id": "system.environment",
      "category": "system",
      "status": "ok",
      "summary": "OS language en-AU",
      "details": {
        "EDITOR": "not set",
        "LANG": "en_AU.UTF-8",
        "VISUAL": "not set",
        "os": "Mac OS 15.6.1 [64-bit]",
        "os language": "en-AU",
        "os type": "Mac OS",
        "os version": "15.6.1"
      },
      "remediation": null,
      "durationMs": 4
    },
    "terminal.env": {
      "id": "terminal.env",
      "category": "terminal",
      "status": "ok",
      "summary": "terminal metadata was detected",
      "details": {
        "COLORTERM": "truecolor",
        "TERMINFO": "/Applications/Ghostty.app/Contents/Resources/terminfo (dir)",
        "TERM_PROGRAM": "ghostty",
        "color output": "enabled",
        "effective locale": "en_AU.UTF-8",
        "stderr is terminal": "true",
        "stdin is terminal": "true",
        "stdout is terminal": "true",
        "terminal": "Ghostty",
        "terminal size": "193x53",
        "terminal version": "1.3.1"
      },
      "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": "codex",
        "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.151.0",
        "check for update on startup": "true",
        "dismissed version": "0.57.0",
        "last checked at": "2026-08-31T08:33:04.811311Z",
        "latest version": "0.152.1",
        "latest version status": "newer version is available",
        "update action": "standalone installer",
        "version cache": "~/.codex/version.json"
      },
      "remediation": null,
      "durationMs": 211
    }
  }
}
What issue are you seeing?

When forking during a tool call, the fork will panic, since a tool call will record the 'start' but not the 'result'.

This happens with /side or /btw often.

What steps can reproduce the bug?

Start /side while the main thread is awaiting a tool call result. The side snapshot contains the call without its output, and debug history normalisation panics.

What is the expected behavior?

You should be able to do /side at any point, it should snapshot before the tool call, no panic.

Additional information

A panic in a /side invocation of any kind should unwind safely back to the main thread and report an error.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the panic through the /side entry point while a tool call is in progress, using the reported Codex CLI version and environment as context. Trace the fork-during-tool-call path and verify that /side completes without panicking while the tool call behavior remains intact.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
cli
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.