Skip to content

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

Open

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.

Activity

  1. zijkx18 commented on Jul 2, 2026

    @zijkx18

    Encountered the same problem...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions