v0.48.0 — first-class Codex support

Codex can now fly with its black box on. ✦

This release makes OpenAI Codex a first-class Agent-Blackbox host alongside Claude Code and OpenCode: the same live map, replay, efficiency score, subagent genealogy, handoff, and optimization loop—without asking you to change how you work.

What’s new

Zero-setup Codex recording

Agent-Blackbox now tails the rollout sessions Codex already writes under $CODEX_HOME/sessions (default: ~/.codex/sessions). It works with both the Codex CLI and desktop app, and recording itself does not install a plugin or modify Codex configuration.

agent-blackbox up --host codex

Want one dashboard for everything?

agent-blackbox up --host all

That starts the Claude Code, Codex, OpenCode, and Gajae-Code recorders together.

Rich, native Codex traces

Codex activity is normalized into the same canonical event model used by the existing hosts, including:

• sessions, turns, prompts, completion, and errors
• model changes plus input/output/cache token telemetry
• shell commands, searches, file reads, edits, creates, and deletes
• structured patches without double-counting fallback events
• MCP and dynamic tool calls
• context compaction, plan updates, and permission requests
• subagent spawning, parent/child grouping, and dedicated agent lanes

The adapter understands both Codex’s structured runtime events and its response-item fallback format, so different Codex surfaces can produce one clean timeline.

Optional in-run optimizer

Recording remains zero-config. If you also want the in-run optimizer, enable it explicitly:

agent-blackbox up --host codex --optimize

Then review and trust the installed commands once with /hooks in Codex.

The optimizer:

• blocks only a conservative, unchanged full-file reread already present in the current context
• carries a compact working-set reminder across turns
• resets read assumptions after compaction
• preserves existing user hooks and removes only Agent-Blackbox entries on uninstall
• fails open—an optimizer problem never breaks the Codex run

Standalone management is also available through install-codex-hooks and uninstall-codex-hooks.

Full feature parity

Codex runs now flow through the existing host-agnostic pipeline, so they receive the same:

• live dashboard and durable local NDJSON trace
• timeline replay and workflow graph
• context-efficiency and effectiveness scoring
• project baselines and custom rule packs
• handoff export
• reversible AGENTS.md efficiency memory

The published CLI bundle now includes the Codex optimizer hook and, as a packaging fix, the existing Claude Code hook as well. Documentation was updated in English, Korean, Chinese, and Japanese.

Safety and privacy

• Recording is read-only and local-first.
• Raw file contents are not stored as trace payloads; sizes and redacted metadata are used instead.
• Home/project paths and recognized secrets are redacted before persistence.
• Optimizer hooks are optional, visible through Codex’s hook review, and deliberately conservative.

Verified before release

• clean npm ci with 0 known vulnerabilities
• 281 tests across 46 test files
• complete workspace, dashboard, and self-contained CLI bundle build
• Ubuntu and Windows GitHub Actions CI passed on the release commit
• live end-to-end capture with Codex CLI 0.144.4
• a real successful rollout reconstructed as two searches, two reads, and exactly one edit
• a real 928-event Codex subagent rollout grouped entirely under its parent run
• live hook probe confirmed the first full-file read succeeds and the unchanged duplicate is blocked
• isolated --host all startup confirmed all supported recorders can run together

Upgrade notes

No data migration is required. Existing Claude Code, OpenCode, and Gajae-Code workflows keep their current behavior. To start recording Codex, select --host codex or include it through --host all.

Full comparison: v0.47.16...v0.48.0