Codex Tool Recovery Guide
When Codex suddenly cannot call file or edit tools and code stops landing in the repository, verify tool state first and then restart implementation from step one after recovery.
Failure pattern
symptomtext
Typical failure pattern:
1. File tools, write tools, or patch tools suddenly become unavailable
2. Codex still responds, but cannot actually write code
3. Planned implementation is interrupted mid-task
4. Repeating the request does not restore tool behavior
5. It looks like a model issue, but it usually is notWhat to check first
first-checktext
First ask Codex to do one explicit check:
1. Confirm whether file tools are currently available
2. Repeat back the currently available tool set
3. If file tools are unavailable, stop planning new implementation details
4. Do not accept "verbal completion" as real code delivery
5. Once tools recover, restart implementation from step onePrompt you can paste to Codex
prompttext
Codex, first check whether file tools are currently available in this session.
If file tools are available:
1. Restart the implementation from step 1
2. Do not skip edit steps
3. Do not assume earlier draft text was written to disk
4. Re-run editing, verification, and save steps
If file tools are unavailable:
1. Tell me exactly which tools are unavailable
2. Stop expanding the implementation plan
3. Wait for tool recovery, then restart from step 1
This is a toolchain-state problem, not a model-quality problem.Recovery workflow
recovery-flowtext
Recommended recovery flow:
1. Confirm tool state first
2. If file tools are back, restart from the original edit path
3. If file tools are still broken, stop producing new implementation drafts
4. After tool recovery, do not continue from the broken midpoint
5. Restart editing, validation, and save steps from the beginning- Do not keep adding new requirements while tools are broken.
- Do not assume draft text equals a landed code change.
- Once file tools recover, rerun the full edit-and-verify flow from the start.
Next steps
- Codex Plugins OAuth Login if the issue is actually around login or plugin mode.
- Codex gpt-image-2 Skill if you want Codex to generate real image files after tool recovery.