codex-imagegenlisted
Install: claude install-skill zigzag-tech/codex-tui-imagegen
# Codex image generation (via tmux pane)
Codex ships a system `imagegen` skill that exposes a **built-in `image_gen`
tool** — OpenAI's latest image model, **free, no `OPENAI_API_KEY`, no fal-ai**.
This is the preferred way to make raster illustrations.
## The one gotcha that defines this whole skill
**The native `image_gen` tool only exists in the interactive Codex TUI.**
`codex exec` (headless) cannot see it and will fall back to writing code or
refusing. So the only reliable path is: keep a **real Codex TUI alive in a
tmux pane** and feed it prompts with `tmux send-keys`. That's what the helper
script automates.
Other hard-won facts:
- `codex -p` is `--profile`, **not** a prompt flag. Don't use it to pass prompts.
- Long/multiline prompts get captured by the TUI as a single `[Pasted Content]`
chunk that **does not auto-submit** — you must send an **extra Enter**. The
script always does this.
- Output lands at `~/.codex/generated_images/<session-uuid>/`, named either
`exec-*.png` (older Codex) or `ig_*.png` (newer `image_gen` tool). The helper
matches **both** globs; if you copy by hand, glob both. (A stale `exec-*`-only
match is what made `gen` hang forever while the pane already showed "Generated".)
- A batch of N images can take ~7–15 min; each single image ~30–120s of
inference — but a flaky connection can add 1–2 min of stream reconnects
*before* inference starts, so the per-image wait defaults to 360s. If a `gen`
times out but the pane shows "Genera