Skip to main content
Agent Journal 2.0 is the current Journal line, on main. It is not yet released, and breaking changes are expected before 2.0.0. Checked against markpollack/agent-journal@453c1d1, snapshot 2.0.0-20261108.225512-21.
Agent Client main records executions through Agent Journal 2.0: its agent-client-journal module depends on journal-ocsf-writer and journal-capture-tck 2.0.0-SNAPSHOT. Released Agent Client 0.32.0 pins Journal 1.10.0. Client’s own side, JournalExecutionRecorder, is described in the Agent Client async lifecycle.

The receiver

TerminalReceiver(root, namespace, options) receives an already accepted Agent Client decision on a separate recording lane. It never runs a provider or changes the decision.

Terminal profiles

The CLI version is recorded, not gated. The earlier versioned names stay readable for recordings of that one version: LEGACY_CLAUDE_PROFILE (client-terminal-claude-2.1.316/1), LEGACY_CODEX_PROFILE (client-terminal-codex-0.166.0/1), and the LEGACY_* retained names.

Qualifier lookup

AcquisitionQualifier, in the TCK’s io.github.markpollack.journal.tck.ocsf.inventory package, lets a producer qualify a sealed one-shot acquisition without naming its CLI:
manifestProfile is the sealed manifest’s own profile member. The registry is fixed, not discovered: Any other profile returns empty. A qualifier refuses an acquisition with IllegalArgumentException, whose message is its verdict, before creating the new directory. This snippet comes from the repository’s terminal receiver guide and was not compiled for this page; the lookup is exercised on real recordings by TerminalRealRecordingTest (TCK) and RealRecordingTest (writer).

Sub-agents

A Claude Code sub-agent’s records form a child core under children/<id>/ in the same package. The sub-agent’s own session file (<session>/subagents/agent-<agentId>.jsonl) is bound to its spawning call from the native bytes and read into that child core. Every shown spawn needs a finished, bound session file; otherwise the archive is INCOMPLETE.