Skip to content

Show local image previews in the TUI #35824

Description

@Kpyruy

What variant of Codex are you using?

Codex CLI (TUI), tested in Kitty

What feature would you like to see?

When Codex references a local image in its final response, it would be useful to show a small preview directly below the path.

Right now, every referenced image has to be opened separately. This becomes inconvenient when working on UI, screenshots, generated images, or other visual tasks.

The original path should remain visible and clickable. The preview should preserve the image's aspect ratio and remain available after resizing the terminal, scrolling through the transcript, or reopening the session with codex resume.

Only images explicitly referenced in the final response should be shown. Images that Codex opened internally while working should not appear in the transcript.

On terminals without the required image support, or when a file is missing or cannot be decoded, Codex should simply leave the path as normal text.

Additional information

I built a proof of concept for this behavior:

Kpyruy@aaea18d

It uses the Kitty graphics protocol and supports PNG, JPG/JPEG, WebP, and GIF files. Previews are reconstructed from the saved final response and the session working directory, so they also work after codex resume without storing image data in the conversation history.

The targeted image, streaming, and resume tests pass locally, as does the full codex-tui test suite.

I am opening an issue first as requested in the contribution guidelines. If this approach fits the project's direction, I would be happy to prepare a pull request if invited.

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIIssues related to the Codex CLITUIIssues related to the terminal user interface: text input, menus and dialogs, and terminal displayenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions