Codex Local

Codex-Local: Enhanced OpenAI Codex CLI

**Fork of OpenAI Codex CLI with advanced orchestrator features, child agent spawning, and enhanced tool capabilities**

🎯 Why This Fork Exists

Codex-Local exists to extend OpenAI's Codex CLI with powerful multi-agent capabilities and enhanced tooling that are not available in the main distribution. This fork adds:

• Multi-Agent Orchestration - Spawn and coordinate specialized child agents
• Enhanced Tool System - Advanced tools with progress reporting and parallel execution
• Custom Configuration - Full control over models, providers, and behavior
• Non-Conflicting Installation - Runs alongside your main Codex/Cursor installation

---

🚀 Key Features

🤖 Multi-Agent Orchestration System

**Core Innovation**: The ability to spawn specialized child agents that can work in parallel and report progress back to a parent agent.

How It Works:

1. Parent Agent receives a complex task
2. Spawn Agent Tool creates specialized child agents for different subtasks
3. Child Agents work independently with their own tool access
4. Return Progress Tool allows child agents to send status updates back to parent
5. Parent Agent coordinates all child agents and synthesizes results

Benefits:

• Parallel Processing - Multiple agents work simultaneously on different aspects of a task
• Specialization - Each agent can focus on a specific domain (e.g., frontend, backend, testing)
• Scalability - Complex projects can be broken down into manageable pieces
• Real-time Updates - Parent agent receives progress reports from all children

🛠️ Enhanced Tool System

Return Progress Tool

• Purpose: Child agents send progress updates to parent agents
• Parameters:
  • task_id (optional): Unique identifier for the task/agent
  • progress (required): Progress message
  • is_final (optional): Whether this is the final update
• Use Case: Long-running tasks where