git:20260127.a423125 to git:20260207.8816d66
6 added, 6 removed. Audit A to A.
# Codex CLI Provider Configuration
This file contains Codex-specific instructions for Claude Octopus workflows.
## Provider Information
- **Provider**: Codex CLI (OpenAI)
- **Emoji**: 🔴
- **API Key**: Uses `OPENAI_API_KEY` environment variable
- **CLI Command**: `codex`
## Usage Patterns
### Invoking Codex
```bash
- # Basic query
+ # Basic query (uses CLI default model)
codex "your question here"
- # With specific model
- codex -m gpt-4 "your question here"
+ # With GPT-5.3-Codex (premium, high-capability)
+ codex --model gpt-5.3-codex "your question here"
# Reading from stdin
echo "your question" | codex
```
### Codex Strengths
Codex excels at:
1. **Technical Implementation Analysis** - Deep code pattern understanding
2. **Framework-Specific Guidance** - React, Next.js, Python, etc.
3. **Code Generation** - Production-ready code examples
4. **API Documentation Analysis** - Understanding official docs
5. **Debugging Assistance** - Error analysis and fixes
### When to Use Codex
Use Codex for:
- Technical implementation details
- Code pattern recommendations
- Framework-specific best practices
- Error debugging and resolution
- API integration patterns
### Cost Considerations
- - Codex uses GPT-4 based models
- - Estimated cost: ~$0.01-0.05 per query
+ - Codex uses GPT-5.3-Codex (high-capability model, $4.00/$16.00 per MTok input/output)
+ - Estimated cost: ~$0.02-0.10 per query
- Cost depends on input/output token count
- - Uses your personal OPENAI_API_KEY
+ - Uses your personal OPENAI_API_KEY (or OAuth via `codex auth`)
## Security
- API key stored securely in `~/.codex/auth.json` (OAuth)
- OR via `OPENAI_API_KEY` environment variable
- Never log or expose API keys in output
- All API calls are authenticated
## Timeout Configuration
Default timeout: 60 seconds
Can be configured in orchestrate.sh:
```bash
CODEX_TIMEOUT=120 # 2 minutes for complex queries
```
## Error Handling
Common errors:
- `401 Unauthorized`: Check API key configuration
- `429 Rate Limited`: Too many requests, wait and retry
- `Timeout`: Query too complex, simplify or increase timeout
## Integration with Workflows
Codex is used in:
- **Discover Phase**: Technical research and implementation analysis
- **Develop Phase**: Code generation and pattern guidance
- **Grapple Phase**: Adversarial review and critique