title: Codex description: Capture OpenAI Codex sessions with dkod. Wrapper setup and transcript format.

Codex

dkod captures Codex (OpenAI CLI) sessions via a wrapper that execs the codex command and tees stdout/stderr.

Setup

dkod init

Capture a session

dkod capture codex -- "your prompt here"

Arguments after -- are passed directly to the codex command.

Example output

$ dkod capture codex -- "add input validation to the signup form"
▸ Wrapping codex session...
▸ Session started — capturing transcript
  ... (Codex session runs normally) ...
▸ 12 messages captured, 3 files touched
✓ Session s-f4g5h6 → refs/dkod/sessions/s-f4g5h6

How it works

The adapter runs codex as a child process, captures stdout and stderr, and parses the transcript format. When the session ends, the transcript and diff are stored as a git ref.