handoff-codex

Handoff to Codex CLI

Delegate tasks to OpenAI Codex CLI to save Claude context.

---

When to Use Codex

Use Codex For	Keep in Claude
Simple file edits	Complex reasoning
Bulk refactoring	Architecture decisions
Code generation from specs	Problem analysis
Documentation updates	Multi-step workflows

---

Prerequisites

npm install -g @openai/codex

---

Handoff Process

1. Prepare Context

## Task for Codex
**Goal**: [What needs to be done]
**Files**: [Which files to modify]
**Details**: [Specific requirements]

2. Generate Command

# Single file
codex "Update login function in src/auth.ts to add rate limiting"

# Multiple files
codex "Refactor console.log to logger in src/**/*.ts"

3. Provide Instructions

• Why Codex is suitable
• Expected changes
• After completion steps

---

Example

## Task: Update All Import Statements

**Command:**
codex "Update all imports from 'lodash' to 'lodash-es' in src/**/*.ts"

**Expected:**
- ~15 files modified
- Each import updated

**After:**
1. Run `npm test`
2. Return if issues arise

---

Benefits

• Token Savings: Simple tasks don't consume Claude context
• Speed: Fast for straightforward edits
• Context Preservation: Keep Claude fresh for complex reasoning