Codex Stuck — Development skill for Claude Code
Detect whether Codex CLI is running or stuck.
How to install Codex Stuck
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open SeemSeam/codex_stuck and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Codex Stuck does
Detect whether Codex CLI is running or stuck. Lightweight terminal status monitor for codex/claude-code automation.
Alternatives in Development
- OpenAI Codex CLI — (Rust implementation) 67.8k ★
- MiniCode Architecture — 简体中文 This document describes the lightweight architecture decisions behind mini-code 388 ★
- Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★
README
codex_stuck
  
**Detect whether Codex is running or stuck.**
*Have you ever experienced Codex running for a long time with no response, wanting to kill it but afraid it's still working silently?*
[English](README.md) | [中文](README_zh.md)
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
- Inject completion markers (
CODEX_DONE) into Codex prompts - Monitor session files (
~/.codex/sessions/*.jsonl) to detect state - 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.shAuto-configures shell (zsh/bash). Restart terminal after install.
Windows (PowerShell)
.\install.ps1Auto-configures PATH. Restart terminal after install.
Usage
After installation, just run:
codexThe terminal title will show **real-time status**.
Uninstall
./uninstall.sh # Linux/macOS/WSL
.\uninstall.ps1 # WindowsConfiguration (optional)
| Variable | Default | Desc
Related Skills
Ticket Triage
Pull all assigned Jira tickets, categorize by priority and status, detect stuck work, and recommend what to wo
Claude Subscription Switcher
Quota-aware Claude Code subscription switcher with OAuth token profiles, status-line telemetry, a terminal das
Noida
The IDE for code your agent writes: a lightweight terminal IDE built around Claude Code and Codex
Hallmonitor
A hall monitor for your coding agents: every Claude Code and Codex session, live, in your terminal, menu bar a
Grok Plugin Claude Code
A lightweight Grok plugin for Claude Code — delegate coding and review tasks to the Grok CLI. A simple reimple
Caflip
A lightweight CLI tool to switch between coding agent accounts, like claude code & codex
Related Agents
Abtop
AI agent monitor for your terminal. Like btop++, but for AI coding agents. Supports Claude Code and Codex CLI.
Agent Of Empires
Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI Coding Agent Terminal Session manager via tmux and
Shux Tui QA
General hard-gate QA subagent for shux TUI, terminal UX, CLI, pane automation, plugin, attach, mouse/input, an
