openai / openai/codex

[macOS] Desktop 26.820.60940 ignores local App Server daemon

Open
#41,112 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app app-server bug
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.820.60940

What subscription do you have?

5x

What platform is your computer?

Darwin 24.6.0 arm64 arm

What issue are you seeing?

After updating Desktop from 26.818.61809 to 26.820.60940,
CODEX_APP_SERVER_USE_LOCAL_DAEMON=1 stopped working.

Even when the managed App Server is already running, Desktop starts a
second private App Server over stdio.

The previous Desktop version connected to the managed daemon using the
local Unix socket.

What steps can reproduce the bug?
  1. Fully quit ChatGPT Desktop.
  2. Start the managed App Server:
    codex app-server daemon start
  3. Run:
    launchctl setenv CODEX_APP_SERVER_USE_LOCAL_DAEMON 1
  4. Open ChatGPT Desktop.
  5. Check the process list and Desktop logs.

Result: two App Server processes are running, and the Desktop log shows
transport=stdio.

What is the expected behavior?

Desktop should connect to the existing managed App Server at:

~/.codex/app-server-control/app-server-control.sock

It should not start a second private App Server.

Additional information

Last working Desktop version: 26.818.61809
Broken Desktop version: 26.820.60940

Before the update, Desktop logs showed transport=websocket.
After the update, they show transport=stdio.

Related issue:
https://github.com/openai/codex/issues/31991

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

Reproduce with codex app-server daemon start, launchctl setenv CODEX_APP_SERVER_USE_LOCAL_DAEMON 1, and the affected Desktop version, then inspect the local-daemon selection using the environment variable and the logged transport. Done means Desktop connects to ~/.codex/app-server-control/app-server-control.sock, logs websocket transport, and does not start a second private App Server.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos, rust
Domain
backend, desktop
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.