What problem does it solve?
Codex Hook Emulation solves the lack of a native hook runtime in Codex by providing a deterministic, script-driven workflow that maps Claude Code hooks to Codex-native actions, enabling safe session management, guarded operations, and auditable records within a repository.
Core Features & Use Cases
- Deterministic hook mapping: Map Claude Code hooks to Codex actions with a stable, script-driven workflow.
- Lifecycle guidance: Use a clear sequence (SessionStart, Track-Intent, Track-Change, Post-Edit, Session-End) to capture decisions, edits, and closeouts.
- Guardrails and bootstrap: Preflight checks guard risky commands and post-edit prompts verify meaningful edits; supports Obsidian-memory bootstrap when bound.
- Repositories and memory integration: Outputs project-memory hints and bootstrap prompts for unbound repos to help bootstrap workflows.
Quick Start
Activate the codex-hook-emulation skill to start a session and exercise the hook workflow (session-start, preflight, track-intent, post-edit, and session-end) in your repository.