codex - 💡(How to fix) Fix Codex 0.132.0 TUI hangs on Android Termux chroot / ZeroTermux, works only through tmux

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Codex CLI 0.132.0 TUI hangs on Android Termux chroot / ZeroTermux when launched directly from the foreground terminal.

The process does not render the TUI and Ctrl+C does not terminate it reliably. The same environment works with Codex 0.128.0. Codex 0.132.0 also works if launched through tmux.

Root Cause

Codex CLI 0.132.0 TUI hangs on Android Termux chroot / ZeroTermux when launched directly from the foreground terminal.

The process does not render the TUI and Ctrl+C does not terminate it reliably. The same environment works with Codex 0.128.0. Codex 0.132.0 also works if launched through tmux.

Fix Action

Workaround

Running the same 0.132.0 CLI through tmux works:

tmux -f /dev/null new-session -A -s codex-new '/usr/local/bin/codex-new'

Code Example

cd /oc
codex

---

TERM=xterm-256color codex
codex --no-alt-screen
codex --no-alt-screen --disable terminal_resize_reflow
TERM=xterm-256color codex --no-alt-screen --disable terminal_resize_reflow

---

tmux -f /dev/null new-session -A -s codex-new '/usr/local/bin/codex-new'
RAW_BUFFERClick to expand / collapse

Summary

Codex CLI 0.132.0 TUI hangs on Android Termux chroot / ZeroTermux when launched directly from the foreground terminal.

The process does not render the TUI and Ctrl+C does not terminate it reliably. The same environment works with Codex 0.128.0. Codex 0.132.0 also works if launched through tmux.

Environment

  • Device: Android ARM64
  • Terminal: ZeroTermux / Termux-like terminal
  • Runtime: Ubuntu chroot
  • Shell: bash
  • Node: v20.19.4
  • npm: 9.2.0
  • Codex version affected: 0.132.0
  • Codex version working: 0.128.0
  • Platform package: @openai/codex-linux-arm64 / aarch64-unknown-linux-musl

Reproduction

Inside the Ubuntu chroot:

cd /oc
codex

Result: terminal hangs; no TUI is shown; Ctrl+C does not reliably exit.

These workarounds did not fix direct launch:

TERM=xterm-256color codex
codex --no-alt-screen
codex --no-alt-screen --disable terminal_resize_reflow
TERM=xterm-256color codex --no-alt-screen --disable terminal_resize_reflow

Workaround

Running the same 0.132.0 CLI through tmux works:

tmux -f /dev/null new-session -A -s codex-new '/usr/local/bin/codex-new'

Expected behavior

Codex 0.132.0 TUI should either launch normally in the foreground terminal or fail gracefully without leaving the terminal in a stuck/raw state.

Actual behavior

The TUI hangs immediately after launch in the foreground terminal. The process remains running and the terminal often needs stty sane or killing the Codex process from another session.

Notes

codex exec works normally on 0.132.0, so API/auth/model configuration is not the problem. This appears to be specific to the interactive TUI terminal handling. The binary contains tui/src/terminal_probe.rs, so this may be related to terminal probing/control sequences not being handled correctly by ZeroTermux/Android chroot foreground TTY.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Codex 0.132.0 TUI should either launch normally in the foreground terminal or fail gracefully without leaving the terminal in a stuck/raw state.

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Codex 0.132.0 TUI hangs on Android Termux chroot / ZeroTermux, works only through tmux