Built-in `imagegen` skill is available, but the `image_gen` tool is not exposed in Codex App
What version of the Codex App are you using (From “About Codex” dialog)?
26.818.41509 (build 6962)
What subscription do you have?
ChatGPT Pro
What platform is your computer?
Darwin 25.6.0 arm64 arm
What issue are you seeing?
Summary
The system-provided imagegen skill is installed and can be loaded, but the built-in image_gen tool is not exposed to the active Codex App task.
As a result, Codex cannot generate an image through the documented built-in image-generation path. It instead redirects the user to the CLI fallback and asks for a separately configured OPENAI_API_KEY.
Actual behavior
Codex discovers the system skill at:
~/.codex/skills/.system/imagegen/SKILL.md
The skill documents image_gen as its preferred built-in execution path, but image_gen is absent from the tool registry exposed to the active task.
No image is generated. Codex reports that the built-in image-generation capability is unavailable and suggests switching to the CLI fallback.
This appears to be a built-in capability-registration or task-tool-provisioning issue:
- The correct system skill is discovered.
- The request is correctly identified as an image-generation request.
- The required built-in
image_gentool is missing. - No generated image or image-generation result is returned.
Impact
The Codex App exposes a system imagegen skill that cannot use its documented primary execution path. Users are redirected to a separate API-key-based CLI workflow even though the installed skill states that its built-in path does not require OPENAI_API_KEY.
What steps can reproduce the bug?
- Launch Codex App on macOS.
- Create a new projectless task.
- Send the following exact prompt:
> 用内部的 imagegen 插件 给我生成一只可爱小猫在太空的图片
English equivalent:
> Use the internal imagegen plugin to generate an image of a cute kitten in space.
- Codex discovers and loads the system-provided
imagegenskill from:
~/.codex/skills/.system/imagegen/SKILL.md
- The skill instructs Codex to use the built-in
image_gentool as the default execution path.
- However,
image_genis not present in the tool registry exposed to the active task.
- Observe that no image is generated. Codex instead reports that the built-in image-generation capability is unavailable and asks the user to use the CLI fallback, which requires a separately configured
OPENAI_API_KEY.
The issue occurred in a new projectless task without any image inputs or project-specific configuration.
What is the expected behavior?
When the system-provided imagegen skill is selected, the Codex App should expose the built-in image_gen tool to the active task and allow the agent to invoke it.
For the reproduction prompt, Codex should:
- Invoke the built-in
image_gentool. - Generate an image of a cute kitten in space.
- Display the generated image directly in the Codex App.
- Complete the request without asking the user to configure an external
OPENAI_API_KEY.
This is consistent with the installed skill documentation, which states that the built-in image_gen path is the preferred default and does not require OPENAI_API_KEY.
If the built-in capability is unavailable for the current account, model, or deployment, the app should clearly report the unavailable feature state. It should not expose a system skill whose required built-in tool is missing from the task.
Additional information
Environment
- Codex App version:
26.818.41509 - Build:
6962 - Bundle identifier:
com.openai.codex - Platform:
Darwin 25.6.0 arm64 arm - Task type: Projectless task
- Request language: Chinese
- Date observed:
2026-08-23
Relevant system skill
The skill is installed at:
~/.codex/skills/.system/imagegen/SKILL.md
The installed skill documentation explicitly states:
Default built-in tool mode (preferred): built-inimage_gentool for image generation, editing, and transparent-image requests. Does not requireOPENAI_API_KEY.
It also states:
Use the built-in image_gen tool by default for normal image generation and editing requests.
The skill itself is therefore available and correctly selected, but its required built-in tool is absent from the active task's tool registry.
Result
- The prompt was accepted.
- The correct
imagegenskill was discovered. - No
image_gencapability was exposed. - No image-generation call was made.
- No image was returned.
- Codex redirected the user to the CLI/API-key fallback.
Possible duplicate
GitHub suggested issue #36370 as a potential duplicate while this report was being created. Please merge or close this report if it describes the same tool-provisioning issue.
Regression status
Unknown. I have not confirmed whether image generation worked in an earlier Codex App version.
I can provide the original conversation screenshot if additional reproduction evidence is needed.
1 Comment
<img width="698" height="862" alt="Image" src="https://github.com/user-attachments/assets/070bb2d2-d5b4-47ae-9644-5ada561435aa" />