Skip to main content

Codex Integration

Pad-Lattice has two Codex paths today.

Non-interactive Codex

Use codex-exec for real Codex CLI runs that expose JSON-line events:

pad-lattice codex-exec "summarize this repository"

The adapter runs:

codex exec --json ...

and maps Codex events to Pad-Lattice states:

Codex eventPad-Lattice state
thread.startedrunning
turn.startedrunning
item.startedrunning
turn.completedsuccess
turn.failederror
errorerror

success and error are transient. The daemon shows them briefly and then returns to waiting_for_reply.

Interactive Codex

Normal codex and codex resume sessions do not automatically emit Pad-Lattice states yet.

The next integration step is a sample Codex hooks.json that users can copy into Codex config. Hooks can update turn-level states such as:

  • prompt submitted
  • running
  • approval needed
  • waiting again

Hooks do not expose every keystroke while the user is typing.