27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
---
|
|
id: codex
|
|
title: Codex
|
|
sidebar_position: 2
|
|
---
|
|
|
|
# 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 declares `"hooks": "./hooks/hooks.json"`. Without the plugin, `bd setup codex` installs the same hook config in `.codex/hooks.json` and enables `[features].hooks = true`.
|