v0.53.0 reports that [config] tools.* are deprecated, but v0.53.0 docs disagree

Resolved 💬 1 comment Opened Oct 31, 2025 by amonks Closed Oct 31, 2025

What is the type of issue?

Documentation is incorrect

What is the issue?

in v0.53.0:

⚠ `tools.view_image` is deprecated. Use `view_image_tool` instead.
You can either enable it using the CLI with `--enable view_image_tool` or through the config.toml file with `[features].view_image_tool`

⚠ `tools.web_search` is deprecated. Use `web_search_request` instead.
You can either enable it using the CLI with `--enable web_search_request` or through the config.toml file with `[features].web_search_request`

in docs/config.md@v0.53.0:

| `tools.web_search`                               | boolean                                                           | Enable web search tool (alias: `web_search_request`) (default: false).                                                     |
| `tools.view_image`                               | boolean                                                           | Enable or disable the `view_image` tool so Codex can attach local image files from the workspace (default: true).          |

the legacy feature warning says that tools.view_image is deprecated and to use view_image_tool, but the docs document tools.view_image and do not mention view_image_tool.

introduced in https://github.com/openai/codex/pull/5976
cc/ @celia-oai

Where did you find it?

_No response_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗