Windows CLI welcome screen shows macOS-only installation tip
Nobody has claimed this yet.
- 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?
- On Windows, open PowerShell.
- Install Codex CLI with:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
- At
Start Codex now? [y/N]:, entery. - 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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