openai / openai/codex

Windows CLI welcome screen shows macOS-only installation tip

Open Beginner friendly
#38,683 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug CLI TUI windows-os
Dominant language
Rust
Stars
125k
Forks
19.5k
PR merge metrics
PR metrics pending

Description

What version of Codex is running?

codex-cli 0.147.0

Which model were you using?

gpt-5.6-sol medium (shown at startup; the issue occurs before model interaction)

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

PowerShell 7.6.4

What steps can reproduce the bug?
  1. On Windows, open PowerShell.
  2. Install Codex CLI with:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
  1. At Start Codex now? [y/N]:, enter y.
  2. Read the tip beneath the Codex CLI welcome screen.
What is the expected behavior?

On Windows, the welcome screen should show a platform-appropriate tip. For example, it could simply say:

Tip: Run codex app to open the Desktop app.

If the desktop app is not available or not installed, the tip should describe the Windows behavior or omit platform-specific installation guidance.

What do you see instead?

The Windows CLI displays a macOS-specific installation note:

Tip: Run codex app to open the Desktop app (it installs on macOS if needed).

This is confusing immediately after the Windows PowerShell installer successfully detects Windows (x64) and installs the Windows CLI.

Relevant installer/startup output:

==> Installing Codex CLI
==> Detected platform: Windows (x64)
==> Resolved version: 0.147.0
==> Downloading Codex CLI
==> PATH updated for future PowerShell sessions.
==> Current PowerShell session: codex
==> Future PowerShell windows: open a new PowerShell window and run: codex
Codex CLI 0.147.0 installed successfully.
Start Codex now? [y/N]: y
==> Launching Codex

OpenAI Codex (v0.147.0)
model:     gpt-5.6-sol medium
directory: ~\Code\tensile

Tip: Run codex app to open the Desktop app (it installs on macOS if needed).
Additional information

The installer correctly identifies the host as Windows. This appears to be an unconditional or insufficiently platform-gated welcome tip rather than an installer platform-detection problem.

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 at the Codex CLI welcome screen startup path, where the codex app tip is displayed, and check how the platform-specific wording is selected. Reproduce the launch flow on Windows and verify that the macOS installation note is absent or replaced with Windows-appropriate guidance while the intended macOS behavior remains unchanged.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
cli
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
76/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.