Skip to content

Codex 0.139.0 renamed codex_hooks to hooks, causing Codex install to fail #208

@LukeLIN-web

Description

@LukeLIN-web

Summary

The Codex installer rejects current Codex CLI releases because it only checks for the old codex_hooks feature name. In Codex CLI 0.139.0, the stable feature is exposed as hooks instead.

Environment

  • Humanize commit: 0ec921a36b4365df503511c5567bbd3e02db0df5 (main on 2026-06-10)
  • Codex CLI: codex-cli 0.139.0
  • Install command: scripts/install-skills-codex.sh
  • OS: Linux

Reproduction

tmp_dir="$(mktemp -d)"
git clone --depth 1 https://github.com/PolyArch/humanize.git "$tmp_dir/humanize"
"$tmp_dir/humanize/scripts/install-skills-codex.sh"

The skill directories and Humanize config are written, but native hook installation fails:

[install-codex-hooks] Error: Installed Codex CLI does not expose the codex_hooks feature. Humanize Codex install requires Codex 0.114.0+.

codex features list on 0.139.0 contains:

hooks                                stable             true

It does not contain codex_hooks. Running codex features enable hooks succeeds.

Affected code

  • scripts/install-codex-hooks.sh checks and enables only codex_hooks.
  • scripts/bitlesson-select.sh passes --disable codex_hooks.
  • docs/install-for-codex.md documents only codex_hooks.

Suggested fix

Detect both names for compatibility, preferring hooks when available, and use the detected feature name for features enable / --disable. Update the Codex install documentation accordingly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions