Codex CLI 0.154.0 hangs on startup on macOS after Homebrew upgrade
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of Codex CLI is running?
0.154.0
What subscription do you have?
Business Premium seat
Which model were you using?
N/A — CLI hangs before startup
What platform is your computer?
Darwin 25.6.0 arm64 arm
What terminal emulator and version are you using (if applicable)?
SSH session into macOS, zsh, tmux also in use
Codex doctor report
not available — `codex doctor --json` also cannot run because every Codex invocation hangs
What issue are you seeing?
Codex CLI 0.154.0 hangs indefinitely immediately on startup after upgrading from 0.153.4 via Homebrew Cask.
There is no stdout/stderr output and the process has to be interrupted manually.
All of these hang:
codex
codex doctor --json
codex --version
codex --help
/opt/homebrew/Caskroom/codex/0.154.0/bin/codex completion bash
This also causes:
brew reinstall --cask codex
to appear to hang at:
==> Linking Binary 'codex' to '/opt/homebrew/bin/codex'
Process inspection shows that Homebrew successfully gets past the actual binary-link step and then launches:
/opt/homebrew/Caskroom/codex/0.154.0/bin/codex completion bash
That Codex process hangs indefinitely.
The issue started immediately after upgrading from 0.153.4 to 0.154.0.
What steps can reproduce the bug?
-
Upgrade Codex CLI installed through Homebrew Cask to 0.154.0.
-
Run:
codex --version
Observe that the process hangs indefinitely with no output.
The same happens with codex --help and normal codex startup.
I also reproduced it while bypassing my normal Codex configuration:
tmp="$(mktemp -d)"
CODEX_HOME="$tmp" /opt/homebrew/Caskroom/codex/0.154.0/bin/codex --version
This still hangs.
I also tested a copied and ad-hoc signed binary:
cp /opt/homebrew/Caskroom/codex/0.154.0/bin/codex /tmp/codex-0.154.0
codesign --force --sign - /tmp/codex-0.154.0
/tmp/codex-0.154.0 --version
codesign succeeds, but the resulting binary still hangs.
What is the expected behavior?
codex --version and codex --help should return immediately, and normal codex startup should launch the CLI.
Additional information
An existing Codex 0.153.4 process that was already running continued to work after the upgrade, but new 0.154.0 processes cannot start.
I initially suspected MCP configuration, but reproducing the issue with a fresh temporary CODEX_HOME appears to rule out my normal Codex configuration.
Homebrew itself does not appear to be the root cause: during reinstall, the child process that hangs is codex completion bash.
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
No source files or tests are named. First reproduce the hang with CODEX_HOME set to a temporary directory using codex --version, codex --help, and codex completion bash, then trace the 0.154.0 startup path on macOS. Done means these commands return promptly and normal Codex startup launches successfully after the Homebrew upgrade.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos, rust, zsh
- Domain
- cli, operating-systems
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100