docs: update Codex hook setup guidance

[annabellscha]

Summary

• replace the removed Codex plugin_hooks feature flag with hooks
• add a required review-and-trust step for the Langfuse Stop hook, including /hooks and hook hash re-review guidance
• expand troubleshooting with codex features list, codex plugin list --json, trust-state guidance, Stop hook success output, debug logging, and .langfuse sidecar notes

Testing

• /Users/annabellschafer/langfuse-docs/node_modules/.bin/prettier --experimental-cli --check .
• node scripts/check-h1-headings.js
• git diff --check
• rg -n "plugin_hooks" content/integrations/developer-tools/codex.mdx (no matches)

Greptile Summary

The PR updates the Codex tracing guide for the current hooks feature and trust workflow.

• Replaces plugin_hooks with hooks and raises the documented Codex minimum.
• Adds hook review and re-review instructions.
• Expands troubleshooting for feature, plugin, trust, sidecar, and debug state.

Confidence Score: 4/5

The PR appears safe to merge after reconciling the non-blocking Codex minimum-version inconsistency.

The setup and trust-flow updates are coherent, but users currently receive conflicting 0.128+ and 0.146+ compatibility requirements across the documentation.

Files Needing Attention: content/integrations/developer-tools/codex.mdx

Prompt To Fix All With AI

### Issue 1
content/integrations/developer-tools/codex.mdx:23
**Conflicting Codex minimum versions**

This line now requires Codex 0.146+, while `content/resources/engineering/coding-agent-tracing.mdx` still advertises Codex 0.128+ for the same integration. Users on versions 0.128–0.145 therefore receive contradictory compatibility guidance and cannot determine whether an upgrade is required.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

_{Reviews (1): Last reviewed commit: "docs: update Codex hook setup guidance" | Re-trigger Greptile}

Greptile also left 1 inline comment on this PR.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
langfuse-docs	Ready	Preview	Aug 3, 2026 3:59pm

[github-actions]

@claude review

[claude]

LGTM — approving despite the minor version-mismatch nit flagged inline.

Extended reasoning...

Overview

This PR is a docs-only change to a single file (content/integrations/developer-tools/codex.mdx), updating the Codex hook setup guidance: replacing the removed plugin_hooks feature flag with hooks, adding a hook review/trust step, and expanding troubleshooting guidance. No code, config, or build logic is touched.

Security risks

None. This is prose/markdown documentation with no executable code, secrets, or auth-sensitive content. The externally-linked hooks documentation URL and version bump were both examined by the bug-hunting system and found to be legitimate (not fabricated or broken links).

Level of scrutiny

Low. This is a low-risk, self-contained documentation update with no CODEOWNERS-sensitive paths and no production code paths affected. The one finding — a stale "Codex 0.128+" version reference in a separate comparison table (content/resources/engineering/coding-agent-tracing.mdx) that should now read "0.146+" — is a minor cross-file consistency nit, not a functional or security defect. It's already surfaced as an inline comment for the author to address.

Other factors

The rest of the diff (hook trust/review workflow, troubleshooting steps, terminology updates from "plugin hooks" to "hooks") is internally consistent and reads correctly. Greptile's independent review reached the same conclusion (confidence 4/5, blocked only by the same version-mismatch nit).