codexlisted

# Codex CLI Delegate coding tasks to [Codex](https://github.com/openai/codex), OpenAI's autonomous coding agent CLI, by running the `codex` command from bash. Codex is interactive, so launch it inside a tmux session when you need to monitor or feed it input from a non-interactive shell. ## When to use - Building features - Refactoring - PR reviews - Batch issue fixing Requires the codex CLI and a git repository. ## Prerequisites - Codex installed: `npm install -g @openai/codex` - OpenAI auth configured: either `OPENAI_API_KEY` or Codex OAuth credentials from the Codex CLI login flow (`codex login`) - **Must run inside a git repository** — Codex refuses to run outside one - Codex is an interactive terminal app; launch it inside tmux when you need to monitor/feed it from a non-interactive bash tool A valid CLI OAuth session may live under `~/.codex/auth.json`; do not treat a missing `OPENAI_API_KEY` alone as proof that Codex auth is missing. ## One-Shot Tasks `codex exec` runs non-interactively and exits when done — safe to run directly: ```bash cd ~/project && codex exec 'Add dark mode toggle to settings' ``` For scratch work (Codex needs a git repo): ```bash cd "$(mktemp -d)" && git init && codex exec 'Build a snake game in Python' ``` ## Background / Long Tasks (tmux) For long or potentially-interactive runs, drive Codex through a tmux session: ```bash # Start a tmux session and launch Codex in it tmux new-session -d -s codex-work -x 140 -y 40 tmux send-key