The tip to run `codex app` doesn't actually work
Resolved 💬 6 comments Opened Feb 5, 2026 by JLCarveth Closed Feb 12, 2026
💡 Likely answer: A maintainer (etraut-openai, contributor)
responded on this thread — see the highlighted reply below.
What version of Codex CLI is running?
codex-cli 0.98.0
What subscription do you have?
N/A
Which model were you using?
gpt-5.3-codex
What platform is your computer?
Linux 6.6.87.2-microsoft-standard-WSL2 x86_64 unknown
What terminal emulator and version are you using (if applicable)?
Windows Terminal
What issue are you seeing?
There is a tip message when you open codex cli:
Tip: New Try the Codex App with 2x rate limits until April 2nd. Run 'codex app' or visit https://
chatgpt.com/codex
Running codex app however, simply passes the text 'app' into the codex cli session:
❯ codex app
╭────────────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.98.0) │
│ │
│ model: gpt-5.3-codex medium /model to change │
│ directory: ~/Developer/east/iris │
╰────────────────────────────────────────────────────╯
Tip: New Try the Codex App with 2x rate limits until April 2nd. Run 'codex app' or visit https://
chatgpt.com/codex
› app
• I’m treating app as a request to work on or run the application in this repo. I’ll quickly inspect
the project to identify the expected app command and proceed from there.
What steps can reproduce the bug?
- Execute
codex app
What is the expected behavior?
Well I expected to try out this new "Codex App"
Additional information
_No response_
6 Comments
The Codex app is available only on macOS today.
We'll change this tip so it's platform-specific.
Thanks for flagging this. To help us reproduce and prioritize:\n\n1. What environment are you using (OS, version, and install method)?\n2. What exact command or config triggers the issue?\n3. Can you share logs or error output if available?\n\nWe will update the proposal once we have the missing details.
@JLCarveth Can confirm this behavior on Windows too: codex app doesn’t launch a native desktop app process in this environment.
I created a temporary technical workaround for early users: https://github.com/friuns/codex-app-for-windows.
It’s basically a Windows compatibility wrapper around the current Electron app package: unpack app, patch what’s platform-specific, rebuild needed native modules for the correct Electron ABI, and run.
Not official and definitely a bridge solution, but useful for testing and day-to-day use until first-party Windows support lands.
Confirming on Linux as of 2026-02-11 with Codex CLI v0.98.0: startup tip says to run
codex app, but this build has noappsubcommand (onlyapp-server), socodex appis treated as prompt text. This makes the tip misleading on Linux.This is fixed in 0.99.