openai / openai/codex

Remote Control fails to connect on macOS – pairing code unavailable

Open
#44,326 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app bug connectivity remote
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.903.61454

What subscription do you have?

Plus

What platform is your computer?

Darwin 25.6.0 arm64 arm

What issue are you seeing?

When I go to:
Settings → Connections → Control this Mac → Add
the pairing screen displays:
Pairing code unavailable: Remote control failed to connect
The QR/pairing code is never generated.

Troubleshooting already attempted:
Fully quit the app with Cmd+Q.
Restarted macOS.
Signed out and signed back in.
Completely uninstalled and reinstalled the Codex/ChatGPT desktop app.
Cleared local Codex application data.
Reset the ~/.codex directory.
The issue persists every time.

Actual behavior
Pairing code unavailable: Remote control failed to connect

Hardware: MacBook Air m5 32gb RAM

What steps can reproduce the bug?

Open Codex / ChatGPT desktop app on macOS.
Go to Settings → Connections → Control this Mac.
Enable Allow connections.
Click Add to pair an iPhone.
Pairing fails before a QR code is generated.

What is the expected behavior?

A pairing code / QR code should be displayed so the iPhone can be authorized.

Additional information

Throughout today, I was repeatedly disconnected from my Mac, even though I have the setting enabled that is supposed to prevent the Mac from going to sleep while ChatGPT is connected.
Despite that, the remote connection kept dropping multiple times during the day.

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 the failure through Settings → Connections → Control this Mac → Add on the reported macOS setup, then trace the remote-control pairing flow from the point where the connection fails. Done means the flow consistently generates a pairing code or QR code and supports authorizing an iPhone without repeated disconnections.

Written by the indexing model from the issue text.

Assessment

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