Codex Stuck

---

Core Idea

A **lightweight** terminal status display plugin for Codex.

It determines whether Codex is stuck by monitoring:

• Session file status
• Traffic changes
• Silence duration

This plugin was created not only for easily detecting Codex status, but also as a monitor for fully automated operation of **[cca](https://github.com/bfly123/claude_code_autoflow)** and **[ccb](https://github.com/bfly123/claude_code_bridge)**.

Solution

1. Inject completion markers (CODEX_DONE) into Codex prompts
2. Monitor session files (~/.codex/sessions/*.jsonl) to detect state
3. Display status in terminal title via OSC sequences

---

Status Icons

Icon	Status	Meaning
▶	Run	Producing output
▷	Think	Pending, low activity
◇	Idle	Long quiet period
□	Free	Waiting for input
■	Stuck	Very long quiet
×	Exit	Process exited

---

Installation

Linux / macOS / WSL

./install.sh

Auto-configures shell (zsh/bash). Restart terminal after install.

Windows (PowerShell)

.\install.ps1

Auto-configures PATH. Restart terminal after install.

---

Usage

After installation, just run:

codex

The terminal title will show **real-time status**.

---

Uninstall

./uninstall.sh      # Linux/macOS/WSL
.\uninstall.ps1     # Windows

---

Configuration (optional)

| Variable | Default | Desc