{"slug":"codex-cli-failing-check","title":"Point Codex CLI at one failing check","summary":"Codex CLI investigates a single red check, patches it, and shows the command output. It does not rewrite the suite to go green.","agent":"Codex CLI","agentSlug":"codex-cli","category":"Coding","categorySlug":"coding","roles":["Software engineer"],"roleSlugs":["software-engineer"],"industries":["Software"],"industrySlugs":["software"],"jobs":["shipping-code"],"topic":"Dev & Coding","topicSlug":"dev-and-coding","score":15,"difficulty":"medium","estCost":"A ChatGPT plan that includes Codex, per OpenAI's current docs. Confirm before you rely on a number from memory.","costTier":"low","timeSaved":"The first hypothesis and the mechanical fix, when the failure is already reproduced locally.","prompt":"The check named below is failing. Reproduce it with the command I give you.\n\nFind the smallest change that makes that command pass. Do not delete tests, skip flags, or widen retries.\n\nIf the failure is environmental (missing secret, unavailable service), stop and say so. Do not stub production services.\n\nPaste the command output before and after. Summarize the diff in five lines.\n\nCHECK:\nCOMMAND:","steps":[{"title":"Install Codex CLI from the current docs","detail":"The manual lives at learn.chatgpt.com/docs/codex/cli. Use that install path rather than a copied one-liner from a chat."},{"title":"Reproduce the failure yourself once","detail":"If you cannot, the agent will invent a story. The command in the prompt should be the one you just ran."},{"title":"Let Codex edit and re-run that command","detail":"Reject a green result that came from skipping the check."},{"title":"Read the five-line summary against the diff","detail":"They should describe the same change. Then open the PR yourself."}],"sourceUrl":"https://learn.chatgpt.com/docs/codex/cli","sourceNote":"Official documentation URL, checked when this seed was written. The prompt and steps are an original AI Playbook Gems playbook, not a quotation of a customer story, and have not been re-run.","date":"2026-10-14","verified":false,"status":"unverified","sponsorUrl":"","metrics":[{"label":"Hands-on time","value":"Review proportional to the surprise in the diff"},{"label":"You still approve","value":"CI policy and the merge"},{"label":"Cost bucket","value":"Low"}],"faq":[{"question":"Has this Codex CLI playbook been re-run for the catalog?","answer":"No. Status is unverified. Paste the prompt, keep the version that worked, and do not treat the time or cost lines as measurements."},{"question":"Can I point it at a red main branch I have not cloned?","answer":"You can try, and you should not. This playbook assumes a local repro so you can see the same output the agent claims."}],"url":"https://aiplaybookgems.com/usecases/codex-cli-failing-check","jsonUrl":"https://aiplaybookgems.com/api/usecases/codex-cli-failing-check"}