openai / openai/codex

Windows Codex App: unified exec fails with `helper_unknown_error: setup refresh had errors`

Open
#40,596 15 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

app bug sandbox tool-calls windows-os
Dominant language
Rust
Stars
125k
Forks
19.4k
PR merge metrics
PR metrics pending

Description

What version of the Codex App are you using (From “About Codex” dialog)?

26.819.11345

What subscription do you have?

ChatGPT Plus

What platform is your computer?

Microsoft Windows NT 10.0.22631.0 x64

What issue are you seeing?

The Codex App cannot start the unified exec terminal helper.

Exact error:

Failed to create unified exec process: helper_unknown_error: setup refresh had errors

The failure occurs before any command starts, including read-only commands such as:

git rev-parse HEAD

Reproduced in:

  • the existing project chat;
  • a newly created chat in the same local project;
  • after restarting the Codex App;
  • after restarting Windows;
  • after Workspace dependency diagnostics reported Codex dependencies look healthy;
  • after reinstalling the Workspace bundle;
  • with [windows] sandbox = "elevated";
  • with [windows] sandbox = "unelevated".

The local project path contains Cyrillic characters. The project and commands worked previously with the same path.

Expected behavior:
The unified exec helper starts and executes the read-only command.

Actual behavior:
The helper fails during setup refresh before the command is launched.

Impact:
Terminal preflight cannot run. Repository staging and commit operations are intentionally paused. No repository changes, staging, or commits were performed during troubleshooting.

The existing .codex/.sandbox/sandbox.log does not contain the current failures. Its last records predate the currently installed Codex App version.

Feedback ID:
01a03853-2618-7b90-9ce3-1d74d3c81a1d

What steps can reproduce the bug?
  1. Open the Codex App on Windows.
  2. Open an existing local-project chat or create a new chat in the same project.
  3. Ask Codex to run a basic read-only terminal command such as git rev-parse HEAD.
  4. The terminal helper fails before the command starts with: Failed to create unified exec process: helper_unknown_error: setup refresh had errors.
  5. Repeat after restarting the app or creating another project chat; the same failure occurs.
What is the expected behavior?

The unified exec terminal helper should initialize successfully and execute the requested command in the configured local project directory.

Additional information

No response

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 failure in the Windows Codex App with git rev-parse HEAD, using the reported project path and both sandbox settings. The report names no source file or test; the .codex/.sandbox/sandbox.log predates the failure, so use the reproducible error and Feedback ID as the initial investigation anchors. Done means the unified exec helper starts and runs the read-only command.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.