用途：将复杂代码任务委托给 Codex AI，包括深度代码分析、跨多文件大规模重构、带安全控制的自动化代码生成与测试。Codex 是所有代码修改与测试的首选执行方式；仅当 Codex 不可用或同一任务连续失败两次时才可回退直接执行，且需记录 CODEX_FALLBACK 并在总结中说明。
主要能力：执行 Codex CLI 并解析结构化 JSON 响应；支持 @ 文件引用、多模型、沙箱控制；返回最终 agent 消息与会话 ID（SESSION_ID）以便续接；支持 --parallel 并行模式，按依赖拓扑排序，支持依赖阻塞、错误隔离与无限并发独立任务。
使用方式：自动调用必须通过 Bash 工具在前台运行，使用 HEREDOC 语法，timeout 固定为 7200000 毫秒。基本形式：codex-wrapper - [working_dir] <<'EOF' 后跟任务内容再以 EOF 结束。简单单行任务可用 codex-wrapper "任务" [working_dir]。续接会话：codex-wrapper resume <session_id> - [working_dir] <<'EOF'。并行：codex-wrapper --parallel < tasks.txt 或使用含 ---TASK---、id、workdir、dependencies、session_id、---CONTENT--- 定界符的 heredoc，且 --parallel 不接受额外命令行参数，workdir 须写在任务块内。超时可用 CODEX_TIMEOUT 环境变量覆盖（毫秒），超时返回退出码 124。二进制为单 Go 二进制、零依赖，可从 GitHub Releases 或 install.sh 安装，支持 Linux/macOS 的 amd64/arm64，需已安装并认证 Codex CLI，使用 --skip-git-repo-check 可在任意目录工作。
限制：须前台运行，不得后台化；并行模式仅从 stdin 读取任务定义；具体收费、价格与沙箱细节暂未提供。