macOS: image paste shortcut documented as Ctrl+V (Windows behavior) — should support/document ⌘+V (Command+V) #10523
Description
What version of Codex is running?
codex-cli 0.94.0
What subscription do you have?
plus
Which model were you using?
No response
What platform is your computer?
Darwin 24.6.0 arm64 arm
What terminal emulator and version are you using (if applicable)?
No response
What issue are you seeing?
In issue #2730, it’s mentioned that images can be pasted via Ctrl+V. This matches Windows/Linux clipboard conventions, but on macOS the standard paste shortcut is ⌘+V (Command+V). The current wording is misleading for macOS users: I initially thought Codex did not support image pasting at all and that the only way to include an image in context was via file path.
What steps can reproduce the bug?
1. Platform: macOS, Codex: [codex-cli ].
2. Copy an image to the clipboard (e.g., take a screenshot with ⌘+Shift+4, or copy an image from a browser).
3. Focus the Codex input field (the interactive chat prompt).
4. Press ⌘+V (Command+V) to paste.
5. Actual: [describe what happens: nothing happens /only text is pasted / an empty placeholder appears / it only works with Ctrl+V / etc.].
6. Expected: On macOS, image paste should work with ⌘+V. If the intended shortcut differs, the docs/UI should clearly state platform-specific shortcuts (Windows/Linux: Ctrl+V; macOS: ⌘+V).
What is the expected behavior?
• On macOS, pasting an image from clipboard should work with ⌘+V, consistent with system conventions; and/or
• Documentation/UI hints should clearly distinguish shortcuts per platform (e.g., “Windows/Linux: Ctrl+V; macOS: ⌘+V”), including any prerequisites.
Additional information
Why this matters
This is a discoverability/usability issue: macOS users may incorrectly believe image paste is unsupported and fall back to path-based workflows. If ⌘+V already works, this is a docs/UI hint bug; if not, it’s a platform shortcut/clipboard handling bug.
Proposed fix
• Update docs/tooltips to show platform-specific paste shortcuts.
• Ensure macOS clipboard image paste is supported via ⌘+V (or document required conditions if there are any).