Codex Integration

Use Beads with Codex through the beads skill, managed AGENTS.md guidance, and native Codex hooks.

bash

bd setup codex
bd setup codex --check

Codex 0.129.0+ supports /hooks, compact lifecycle hooks, and hook-provided developer context. Beads uses that lifecycle to inject bd prime on session start and recover context after compaction.

Hook Lifecycle

SessionStart (startup|resume|clear) injects full bd prime output.
PreCompact (manual|auto) checks bd prime --memories-only and warns if Beads context is unavailable.
PostCompact (manual|auto) records that the session needs a Beads refresh.
UserPromptSubmit injects full bd prime once after compaction, then clears the refresh marker.

PreCompact alone does not inject context because Codex ignores plain stdout from compact hooks. The post-compact marker plus first-prompt refresh is the reliable recovery path.

The Beads Codex plugin stores hooks at plugins/beads/.codex-plugin/hooks/hooks.json and declares them as "hooks": "./hooks/hooks.json". Without the plugin, bd setup codex installs the same hook config in .codex/hooks.json and enables [features].hooks = true.