What problem does it solve?
It reduces the overhead of doing large, multi-step repository changes in a single chat context by delegating heavy implementation and exploration to Codex CLI while keeping the orchestration agent focused.
Core Features & Use Cases
- Multi-step subagent delegation: Runs long-horizon repo work (edits, refactors, exploration) in an isolated Codex session using a single handoff prompt.
- Context handoff that preserves intent: Passes the original goal, prior decisions, scope, constraints, and verification requirements so the isolated run stays aligned.
- Verification-first outcomes: Enforces running an explicit test/lint/typecheck command before returning results, then reconciles decisions and diffs back to the main thread.
- Use Case: When you need a feature slice that touches multiple files (implementation + docs + tests), delegate the whole plan to Codex, have it apply minimal diffs, and require the test suite to pass.
Quick Start
Ask your orchestrator agent to delegate this task to codex-cli by providing the goal, current decisions, repository scope, constraints, and the verification command you want Codex to run.