codex-fix

What problem does it solve?

This Skill provides a concise diagnostic reference and targeted fixes for failures in the Codex CLI, including bubblewrap (bwrap) sandbox permission errors, stream disconnections, unexpected exits, and behavior differences between codex review and codex exec. It helps developers quickly identify whether failures are caused by sandboxing, environment mappings, large diffs, network/proxy instability, or tmux/session issues and advises minimal, safe corrective actions.

Core Features & Use Cases

• Sandbox diagnostics: Steps to verify bwrap installation, setuid bit, and subuid/subgid mappings to resolve RTM_NEWADDR and uidmap permission errors.
• Stream and diff handling: Guidance to retry transient disconnects, determine diff size thresholds, and choose commit-by-commit review or codex exec for large diffs.
• Fallbacks and verification: Environment variable bypass instructions, tmux cleanup tips, and verification commands to confirm the fix worked.
• Use Case: When codex review repeatedly fails on a CI or developer machine, use this Skill to determine whether to install/configure bubblewrap, split the review, or switch to codex exec for a stable stream.

Quick Start

Retry the original failing codex command up to three times, then follow the matching diagnostic section below and apply the recommended fix for bwrap, stream, or diff-size issues.