codex-worker

What problem does it solve?

Orchestrate multiple Codex CLI agents running in parallel, enabling decomposition of complex tasks into independent subtasks and reducing overall completion time.

Core Features & Use Cases

• Parallel task execution: spawn multiple codex workers, each in its own git worktree and tmux session, to tackle subtasks concurrently.
• Preflight checks: validate that codex, tmux, and git are available and that the repository supports worktrees.
• Clear naming and lifecycle: standardized task names, worktrees, and tmux sessions to simplify monitoring and cleanup.
• Use cases: triage multiple issues, refactor several modules, and run lint/tests across packages in parallel.
• Replaces Task tool when codex and tmux are available to enable richer agent capabilities.

Quick Start

Create a codex worker by launching a new tmux session and a dedicated worktree for your task, then attach to the session to interact with the agent.