codex-worker

What problem does it solve? Decomposing a large task into independent subtasks is easy, but executing them in parallel with full agent capabilities is hard. This Skill orchestrates multiple Codex CLI agents simultaneously, each running in its own tmux session and isolated git worktree, so batch triage, parallel fixes, and multi-module refactors happen concurrently without branch conflicts. ## Core Features & Use Cases - Parallel Worker Spawning: Launch one Codex agent per subtask, each with its own git branch, worktree directory, and tmux session following a consistent naming convention. - Interactive Multi-Turn Control: Send prompts to running workers via tmux send-keys, peek at output with capture-pane, or attach to a session for hands-on intervention. - Lifecycle Management: List active workers, kill finished sessions, clean up worktrees and branches, and batch-remove dead tmux sessions. - Use Case: When asked to triage all GitHub issues updated in the last 7 days, fetch the issue list and spawn one codex worker per issue, each analyzing root causes and proposing fixes in its own worktree. ## Quick Start Ask the agent to split the current task into independent subtasks and spawn a codex worker for each one in parallel using tmux and git worktrees.