Image paste/drag-drop issues on macOS: inconsistent behavior with Cmd+V and Ctrl+V, multiple file paste/drag-drop, unclear UX, etc

What version of Codex is running?

codex-cli 0.31.0

Which model were you using?

N/A

What platform is your computer?

macOS (Darwin 23.6.0 x86_64 i386) - using iTerm2 terminal

What steps can reproduce the bug?

1. Take a screenshot to clipboard using Cmd+Ctrl+Shift+4 and select a region.
2. In Codex TUI, try to paste with Cmd+V — nothing happens; try Ctrl+V — image is attached.
3. In Chrome, right click an image and select 'copy image'. In Codex, try Cmd+V — nothing happens; try Ctrl+V — image is attached.
4. In Finder, copy a single image file and paste with Cmd+V — image is attached as expected. This also works fine with Ctrl+V.
5. In Finder, copy multiple image files and paste with Cmd+V — file paths are pasted as text. Paste with Ctrl+V — only the first image is attached.
6. In Finder, drag a single image file and drop it onto the Codex session - image is attached as expected.
7. In Finder, drag multiple image files and drop them onto the Codex session — file paths are added as text
8. Copy some normal text and paste with Cmd+V — text is pasted; Ctrl+V — nothing happens.
9. Review PR #3211 for recent changes/fixes to paste behavior.

What is the expected behavior?

Both shortcuts work for all image paste scenarios, or clear documentation/UI guidance is provided about their limitations.

Ideally, both Cmd+V and Ctrl+V should consistently support all image paste cases described in the docs (screenshots, image copies from browsers, Finder files—single and multiple). If there are technical limitations (e.g., terminal key handling or clipboard format issues), these should be explicitly documented and clarified in the UI and docs.

When multiple images are copied, all should be attached, or a clear message should explain limits. Paste from Chrome/right-click should work if possible. Users should not have to guess which paste shortcut to use for which clipboard content.

What do you see instead?

Image paste behavior is inconsistent and confusing on macOS:

• Taking a screenshot to clipboard (Cmd+Ctrl+Shift+4) and pasting with Cmd+V does not attach the image; Ctrl+V works.
• Copying an image via right-click in Chrome and pasting with Cmd+V does not work; Ctrl+V sometimes works.
• Copying a single image file in Finder and pasting with Cmd+V does work and attaches the image.
• Copying multiple image files in Finder and pasting with Cmd+V pastes the file paths as text; Ctrl+V pastes only the first image (should attach all, up to a reasonable limit).
• Copying normal text and pasting with Cmd+V works; Ctrl+V does nothing (unexpected if Ctrl+V is the canonical paste for images).
• etc (refer to reproduction steps above for canonical list)

This leads to a confusing experience. As a (well informed and technical) user, I assumed image paste was simply broken / non-existent until I saw a fix (PR #3211) and tried Ctrl+V specifically.

Additional information

• The current docs (https://github.com/openai/codex/blob/main/docs/getting-started.md#image-input) imply both Cmd+V and Ctrl+V work for image paste, but this is only true for some clipboard sources.
• The recent PR #3211 fixed some paste/image issues, but there are still confusing edge cases.
• If terminal limitations prevent Cmd+V from being detected, this should be made clear to users (in the docs and maybe in-app help).
• The UX for pasting multiple images should be improved (either support or error/warning if not supported).
• Discovery is an issue: users may not realize Ctrl+V can paste images if Cmd+V doesn't work as expected.