Issue Station
Sign In
Tools hereToolbox

codex - 💡(How to fix) Fix Deprecation notice links to malformed hooks docs URL (`/codex/hooks.` returns 404) [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#21148•Fetched 2026-05-06 06:25:55
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
zichen0116zichen0116
Participants
zichen0116zichen0116
Timeline (top)
labeled ×3closed ×2

Root Cause

  1. Open or copy the URL exactly as shown.
  2. Actual result: https://developers.openai.com/codex/hooks. returns 404 because the trailing period is treated as part of the URL.

Code Example

notify = ["notify-send", "Codex"]

---

Switch to a `Stop` hook for end-of-turn automation. See https://developers.openai.com/codex/hooks.
RAW_BUFFERClick to expand / collapse

What issue are you seeing?

A user-facing deprecation notice currently points to a malformed hooks documentation URL with a trailing period:

https://developers.openai.com/codex/hooks.

That exact URL returns 404, so the notice sends users to a broken page instead of the hooks docs.

I found the malformed URL in the runtime deprecation notice string here:

  • codex-rs/core/src/session/session.rs

The same malformed URL is mirrored in the regression test expectation here:

  • codex-rs/core/tests/suite/deprecation_notice.rs

What steps can reproduce the bug?

  1. Configure the deprecated notify setting so Codex emits the deprecation notice. For example:
notify = ["notify-send", "Codex"]
  1. Start Codex so it loads the config and emits the warning.
  2. Observe the deprecation details text:
Switch to a `Stop` hook for end-of-turn automation. See https://developers.openai.com/codex/hooks.
  1. Open or copy the URL exactly as shown.
  2. Actual result: https://developers.openai.com/codex/hooks. returns 404 because the trailing period is treated as part of the URL.

Independent verification from the repo side:

  • codex-rs/core/src/session/session.rs:588 contains the malformed URL in the emitted notice.
  • codex-rs/core/tests/suite/deprecation_notice.rs:144 asserts the same malformed URL.

What is the expected behavior?

The deprecation notice should link to the real hooks documentation URL without trailing punctuation:

https://developers.openai.com/codex/hooks

Additional information

This looks like a narrow repo-owned fix:

  • update the deprecation notice string in codex-rs/core/src/session/session.rs
  • update the matching assertion in codex-rs/core/tests/suite/deprecation_notice.rs

I also checked for duplicates before filing and did not find an existing issue specifically tracking this malformed hooks URL.

If this scope matches maintainers' intent, I can prepare a focused fix branch and open a PR if invited under the repo's contribution policy.

extent analysis

TL;DR

Remove the trailing period from the hooks documentation URL in the deprecation notice string.

Guidance

  • Update the codex-rs/core/src/session/session.rs file to remove the trailing period from the URL in the deprecation notice string.
  • Update the matching assertion in codex-rs/core/tests/suite/deprecation_notice.rs to reflect the corrected URL.
  • Verify the fix by configuring the notify setting, starting Codex, and checking that the deprecation notice links to the correct URL.
  • Test the fix by copying and opening the URL from the deprecation notice to ensure it returns a valid page.

Example

The corrected deprecation notice string should be:

Switch to a `Stop` hook for end-of-turn automation. See https://developers.openai.com/codex/hooks

Notes

This fix assumes that the only issue is the trailing period in the URL. If there are other problems with the deprecation notice or the URL, additional changes may be needed.

Recommendation

Apply workaround: Remove the trailing period from the URL, as this is a simple and targeted fix that addresses the specific issue reported.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#GPU compatibility#latency issue#model loading#dependency error#configuration error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Deprecation notice links to malformed hooks docs URL (`/codex/hooks.` returns 404) [1 participants]