Skip to main content
AI/MLLeeJuOh

codex-status

List active and recent Codex jobs plus stored review files. Use when asked \"codex status\", \"진행중인 코덱스\", or wants to see Codex job state.

Stars
45
Source
LeeJuOh/claude-code-zero
Updated
2026-05-25
Slug
LeeJuOh--claude-code-zero--codex-status
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/LeeJuOh/claude-code-zero/HEAD/plugins/codex-advisor/skills/codex-status/SKILL.md -o .claude/skills/codex-status.md

Drops the SKILL.md into .claude/skills/codex-status.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Codex Job Status + Stored Reviews

Thin wrapper around the Official Codex companion's status subcommand, combined with a listing of review files saved by codex-advisor. Useful when the user has disabled the Official plugin's slash commands but still wants job visibility.

Phase 1: Invoke companion status

set -o pipefail
CODEX_COMPANION=$("${CLAUDE_PLUGIN_ROOT}/scripts/resolve-companion.sh") \
  || { echo "Official Codex plugin not found — run /codex-setup" >&2; exit 1; }

# Forward args verbatim. The companion handles [job-id], --wait,
# --timeout-ms, --all, and prints a markdown table.
node "$CODEX_COMPANION" status $ARGUMENTS

Relay the companion's output verbatim. Do NOT reformat — the companion already renders a compact table.

Phase 2: List stored review files

Codex-advisor writes reports to ${CLAUDE_PLUGIN_DATA}/reviews/. Add a short section listing the most recent files so the user can correlate jobs with saved reports:

REVIEWS_DIR="${CLAUDE_PLUGIN_DATA}/reviews"
if [ -d "$REVIEWS_DIR" ]; then
  ls -1t "$REVIEWS_DIR" 2>/dev/null | head -10
fi

Format:

## Recent codex-advisor reports

- review-20260414-102530.md
- rescue-20260414-100112.md
- ...

Location: ${CLAUDE_PLUGIN_DATA}/reviews/

If the directory doesn't exist yet, skip the section (don't create it).

Gotchas

  • Don't reformat the companion's table. Its markdown is already compact; reformatting risks dropping columns.
  • --wait blocks up to --timeout-ms (default 240000 = 4 min). If the user passes --wait on a running job, surface a "blocking for up to N seconds" note so they aren't surprised by the pause.
  • --all includes completed jobs across sessions. Without it, status shows only the current workspace's jobs.
  • Stored reports and companion jobs are not 1:1. A job that failed before codex-advisor's Phase 5 has no report; a review-<ts>-failed.md corresponds to a companion job that completed with an error. Don't assert matching.