Skip to content

Clarify Codex hook setup troubleshooting#205

Merged
Siddhant-K-code merged 1 commit into
mainfrom
fix/codex-hook-setup-guidance
Jun 11, 2026
Merged

Clarify Codex hook setup troubleshooting#205
Siddhant-K-code merged 1 commit into
mainfrom
fix/codex-hook-setup-guidance

Conversation

@Siddhant-K-code

Copy link
Copy Markdown
Owner

Summary

  • Add a Codex-specific setup checklist after agent-strace setup --cli codex output.
  • Document the normal Codex hook paths, the nested plugin hook path trap, [features].hooks = false, and the reload/trust step.
  • Bump package version to 0.79.1 for the setup-output improvement.

Context

The generated hook schema is already valid for Codex, but users can end up with a valid-looking file that the Hooks UI does not list when it is in the wrong config layer/path, hooks are disabled in config.toml, or the UI has not reloaded/reviewed the command hooks.

Verification

  • python3 -m pytest tests/test_codex_hooks.py tests/test_cursor_hooks.py tests/test_gemini_hooks.py -q -> 21 passed
  • python3 -m compileall -q src/agent_trace && git diff --check
  • python3 -m agent_trace.cli --version -> agent-strace 0.79.1

Co-authored-by: Codex <noreply@openai.com>
@Siddhant-K-code Siddhant-K-code added the documentation Improvements or additions to documentation label Jun 11, 2026
@Siddhant-K-code Siddhant-K-code merged commit c054f6c into main Jun 11, 2026
4 checks passed
@Siddhant-K-code Siddhant-K-code deleted the fix/codex-hook-setup-guidance branch June 11, 2026 02:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant