Attach a screenshot to your prompt

interactive sessions

// what it does

-i/--image attaches one or more image files to the initial prompt — comma-separate several or repeat the flag. It is handy for error screenshots, UI mockups, and diagrams. Once you are in the TUI you can also drag images straight into the composer.

// shell

$ codex -i mockup.png "build this screen"
$ codex --image before.png,after.png "what changed between these?"

// gotcha

The flag only attaches to the initial prompt. To add an image later in the conversation, drag it into the composer or use /mention.

// resources