What problem does it solve?
This Skill parses Codex CLI NDJSON logs to quickly reveal the results of executions, reducing the need to manually inspect verbose logs.
Core Features & Use Cases
- Log overview: generate a concise execution summary including command counts, failures, and token usage from NDJSON logs.
- Failure tracing: identify failing commands and provide details to accelerate debugging.
- Change inspection: highlight file changes and notable edits reported in the logs.
- Mode-based queries: filter logs by batch, search for specific events, or drill into individual entries.
Quick Start
Step 1: Generate the index and manifest for Codex outputs
bash <codex-outputs>/scripts/codex-index.sh
Step 2: View an overview
cat <codex-outputs>/MANIFEST.md
Step 3: Run targeted inquiries (examples)
jq '.logs[] | select(.stats.failed_commands > 0) | {file, failed: .failed_commands_detail}' <codex-outputs>/INDEX.json
jq '.logs[] | select(.item.type == "item.completed" and .item.type == "reasoning") | .item.text' <log_file>