False deprecation warning: [features].codex_hooks when using [features].hooks

Open 💬 1 comment Opened May 27, 2026 by papperrollinggery

Description

Codex CLI v0.129.0 shows a deprecation warning on every session start:

[features].codex_hooks is deprecated. Use [features].hooks instead.
Enable it with --enable hooks or [features].hooks in config.toml.

However, config.toml already uses the correct key:

[features]
hooks = true

There is no codex_hooks key anywhere in:

  • ~/.codex/config.toml
  • Project-level .codex/config.toml
  • Environment variables
  • Codex Desktop app Preferences

The warning appears to be a false positive. The binary has an internal feature flag named codex_hooks (found via strings in the native binary at @openai/codex-darwin-arm64), and the deprecation check may be triggering on the internal flag name rather than the actual config key.

Steps to Reproduce

  1. Set [features] hooks = true in ~/.codex/config.toml
  2. Start a Codex CLI session
  3. Warning appears

Expected Behavior

No deprecation warning when using the correct [features].hooks key.

Environment

  • Codex CLI: v0.129.0
  • Platform: macOS (darwin-arm64)
  • Installed via: npm install -g @openai/codex

View original on GitHub ↗

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