Saltar al contenido principal

Codex

Codex está verificado a nivel de código, con tests unitarios (test_codex_hooks.py), y validado en vivo del lado de captura: sesiones reales de Codex se serializan a checkpoints desde el 2026-08-06 — el log de serialización del maintainer registra capturas tanto de codex-session-end como de codex-stop con throttling desde transcripts de rollout, y hay checkpoints en registro cuyo id de sesión es el archivo de rollout. El parser de transcripts sigue el formato de rollout de Codex a medida que deriva (los eventos item_completed de 0.147.0 se manejan desde daimon 0.27.0). Alcance declarado con honestidad: la validación tiene la profundidad de una sola máquina del maintainer, no de una flota.

Instalación​

Agrega el ciclo de captura -> inyección de Daimon a Codex desde el paquete publicado (sin necesidad de clonar el repo):

daimon hooks install codex

Esto copia los tres scripts de hook y su helper compartido a ~/.codex/hooks/ y registra SessionStart, SessionEnd y Stop en ~/.codex/hooks.json, preservando cualquier entrada no relacionada que ya exista. Es idempotente — re-ejecútalo después de cada uv tool upgrade daimon-briefing para refrescar los scripts y que coincidan con el CLI instalado. Tras instalar, abre /hooks en Codex para revisar y confiar en las definiciones de hooks — Codex omite las definiciones no confiadas hasta que lo hagas.

Una copia instalada obsoleta sigue funcionando con el comportamiento viejo, así que la deriva es invisible. Ejecuta daimon hooks status para auditar las copias instaladas contra las versiones empaquetadas (CURRENT/STALE/MISSING, más el estado de registro en hooks.json); sale con código distinto de cero cuando algo derivó, y daimon hooks install codex lo refresca en el lugar.

Requiere el CLI daimon en el PATH (el alias obsoleto daimon-briefing también funciona como respaldo):

uv tool install 'daimon-briefing[pretty]'

Instalación manual (desde un clon)​

Trabajando desde un checkout del código, el gestor de ciclo de vida independiente ofrece la misma integración más uninstall y status:

python3 hook/codex-hooks.py install   [--dry-run]
python3 hook/codex-hooks.py uninstall [--dry-run]
python3 hook/codex-hooks.py status

Qué hace cada script​

  • daimon-codex-session-end.py — hook SessionEnd. Serializa la sesión terminada en segundo plano cuando Codex la cierra de forma ordenada.
  • daimon-codex-session-start.py — hook SessionStart. Lee el último checkpoint del proyecto y devuelve JSON additionalContext de Codex, así el briefing se inyecta como contexto de desarrollo.
  • daimon-codex-stop.py — hook Stop. Codex expone Stop a nivel de turno, no como un evento limpio de fin de sesión, así que este hook serializa de forma oportunista y está regulado por DAIMON_CODEX_MIN_SERIALIZE_INTERVAL (por defecto 300 segundos por sesión). Ponlo en 0 para serializar cada turno, o pon DAIMON_CODEX_SERIALIZE_ON_STOP=0 para desactivar la captura de Codex dejando instalada la inyección del briefing.

La documentación de Codex señala que transcript_path se provee por conveniencia pero su formato no es una interfaz estable. El parser JSONL de Daimon es deliberadamente best-effort e ignora filas desconocidas en lugar de tratar JSON crudo como texto del transcript.

Enséñale el protocolo al agente​

daimon skill install codex       # bloque gestionado en ~/.codex/AGENTS.md

En el archivo compartido AGENTS.md, daimon solo toca su propio bloque marcado — daimon skill uninstall codex elimina exactamente ese bloque. Re-ejecuta install después de actualizar daimon para refrescar el contenido.

Verificar​

daimon status

daimon status reporta la salud de captura con honestidad, incluidas fallas, omisiones y crashes.